Jupiter History API
The History API from Jupiter — 1 operation(s) for history.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/jupiter-ag:jupiter-ag-history-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Jupiter Prediction Market History API
version: 1.0.0
description: Jupiter Prediction Market API Schema
servers:
- url: https://api.jup.ag/prediction/v1
description: Jupiter Prediction Market API Endpoint
security:
- ApiKeyAuth: []
tags:
- name: History
paths:
/history:
get:
tags:
- History
summary: Get history
description: Paginated history of order, fill, settlement and claim events. Filter by `ownerPubkey` or `positionPubkey`, or pass `id` to fetch a single event. Paginate with `start` and `end`.
parameters:
- schema:
type:
- integer
- 'null'
minimum: 0
required: false
description: Pagination start index of the page to return.
name: start
in: query
- schema:
type:
- integer
- 'null'
minimum: 0
required: false
description: Pagination end index of the page to return.
name: end
in: query
- schema:
type: string
minLength: 32
description: History owner public key
required: false
description: History owner public key
name: ownerPubkey
in: query
- schema:
type: integer
minimum: 1
description: History event ID
required: false
description: History event ID
name: id
in: query
- schema:
type: string
minLength: 32
description: Filter by position public key
required: false
description: Filter by position public key
name: positionPubkey
in: query
responses:
'200':
description: Paginated event history, or single event when id is provided
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/HistoryEvent'
pagination:
$ref: '#/components/schemas/Pagination'
required:
- data
- pagination
operationId: getHistory
x-operation-id-source: derived
components:
schemas:
EventMetadata:
type: object
properties:
eventId:
type: string
title:
type: string
subtitle:
type: string
slug:
type: string
series:
type: string
closeTime:
type: string
description: ISO 8601 formatted close time
imageUrl:
type: string
format: uri
isLive:
type: boolean
required:
- eventId
Pagination:
type: object
properties:
start:
type: integer
minimum: 0
end:
type: integer
minimum: 0
total:
type: integer
minimum: 0
hasNext:
type: boolean
required:
- start
- end
- total
- hasNext
HistoryEvent:
type: object
properties:
id:
type: integer
description: Unique history event identifier
eventType:
type: string
enum:
- order_created
- order_filled
- order_failed
- order_closed
- payout_claimed
- position_updated
- position_lost
description: Type of history event. Position wins surface as payout_claimed (there is no position_won).
signature:
type: string
description: Solana transaction signature
slot:
type: string
description: Solana slot number (u64 as string)
timestamp:
type: integer
description: Unix timestamp (seconds) when the event occurred
orderPubkey:
type: string
description: Associated order account public key
positionPubkey:
type: string
description: Associated position account public key
marketId:
type: string
description: External market identifier
ownerPubkey:
type: string
description: Position or order owner public key
keeperPubkey:
type: string
description: Keeper that processed the transaction
externalOrderId:
type: string
description: Client-provided order identifier
orderId:
type: string
description: External order identifier from the venue
isBuy:
type: boolean
description: True when the event relates to a buy order
isYes:
type: boolean
description: True when the event relates to the YES side
contracts:
type: string
description: Number of contracts in the order. Legacy whole-contract value; see contractsMicro/contractsDecimal for the exact quantity.
contractsMicro:
type: string
description: Contracts in micro-contract units (u64 as string, 1000000 = 1 contract)
contractsDecimal:
type: string
description: Contracts as a decimal string
filledContracts:
type: string
description: Number of contracts filled (legacy whole-contract value)
filledContractsMicro:
type: string
description: Filled contracts in micro-contract units
filledContractsDecimal:
type: string
description: Filled contracts as a decimal string
contractsSettled:
type: string
description: Number of contracts settled in this event (legacy whole-contract value)
contractsSettledMicro:
type: string
description: Settled contracts in micro-contract units
contractsSettledDecimal:
type: string
description: Settled contracts as a decimal string
maxFillPriceUsd:
type: string
description: Maximum fill price in micro USD (u64 as string)
avgFillPriceUsd:
type: string
description: Average fill price in micro USD (u64 as string)
maxBuyPriceUsd:
type:
- string
- 'null'
description: Buyer-specified max fill price in micro USD (u64 as string)
minSellPriceUsd:
type:
- string
- 'null'
description: Seller-specified min fill price in micro USD (u64 as string)
depositAmountUsd:
type: string
description: Amount deposited for this order in micro USD (u64 as string)
totalCostUsd:
type: string
description: Total cost of the order in micro USD (u64 as string)
feeUsd:
type:
- string
- 'null'
description: Fee charged for this event in micro USD (u64 as string)
grossProceedsUsd:
type: string
description: Gross proceeds before fees in micro USD (u64 as string)
netProceedsUsd:
type: string
description: Net proceeds after fees in micro USD (u64 as string)
transferAmountToken:
type:
- string
- 'null'
description: Token amount transferred in this event (native token units as string)
realizedPnl:
type:
- string
- 'null'
description: Realized PnL from this event in micro USD (i64 as string)
realizedPnlBeforeFees:
type:
- string
- 'null'
description: Realized PnL before fees in micro USD (i64 as string)
payoutAmountUsd:
type: string
description: Payout amount in micro USD (u64 as string), populated for payout_claimed events
eventId:
type: string
description: External event identifier
marketMetadata:
allOf:
- $ref: '#/components/schemas/MarketMetadata'
- properties:
marketId:
type: string
eventId:
type: string
title:
type: string
status:
type: string
result:
type: string
closeTime:
type: number
openTime:
type: number
isTeamMarket:
type: boolean
description: Metadata for the associated market
eventMetadata:
$ref: '#/components/schemas/EventMetadata'
description: Metadata for the parent event
required:
- id
- eventType
- signature
- slot
- timestamp
- orderPubkey
- positionPubkey
- marketId
- ownerPubkey
- keeperPubkey
- externalOrderId
- orderId
- isBuy
- isYes
- contracts
- filledContracts
- contractsSettled
- maxFillPriceUsd
- avgFillPriceUsd
- maxBuyPriceUsd
- minSellPriceUsd
- depositAmountUsd
- totalCostUsd
- feeUsd
- grossProceedsUsd
- netProceedsUsd
- transferAmountToken
- realizedPnl
- realizedPnlBeforeFees
- payoutAmountUsd
- eventId
- marketMetadata
- eventMetadata
MarketMetadata:
type: object
properties:
marketId:
type: string
eventId:
type: string
title:
type: string
subtitle:
type: string
description:
type: string
provider:
type: string
status:
type: string
result:
type:
- string
- 'null'
closeTime:
type: number
openTime:
type: number
isTeamMarket:
type: boolean
marketOptions:
type: array
items:
type: object
properties:
label:
type: string
buyYes:
type: boolean
rulesPrimary:
type: string
rulesSecondary:
type: string
required:
- marketId
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Get API key via https://developers.jup.ag/portal
x-provenance:
method: harvested
publisher: Jupiter
source: https://developers.jup.ag/docs/openapi-spec/prediction/prediction.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)