Skip to main content
GET
/
history
cURL
curl --request GET \
  --url https://api.jup.ag/prediction/v1/history \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": 123,
      "eventType": "order_created",
      "signature": "<string>",
      "slot": "<string>",
      "timestamp": 123,
      "orderPubkey": "<string>",
      "positionPubkey": "<string>",
      "marketId": "<string>",
      "ownerPubkey": "<string>",
      "keeperPubkey": "<string>",
      "externalOrderId": "<string>",
      "orderId": "<string>",
      "isBuy": true,
      "isYes": true,
      "contracts": "<string>",
      "filledContracts": "<string>",
      "contractsSettled": "<string>",
      "maxFillPriceUsd": "<string>",
      "avgFillPriceUsd": "<string>",
      "maxBuyPriceUsd": "<string>",
      "minSellPriceUsd": "<string>",
      "depositAmountUsd": "<string>",
      "totalCostUsd": "<string>",
      "feeUsd": "<string>",
      "grossProceedsUsd": "<string>",
      "netProceedsUsd": "<string>",
      "transferAmountToken": "<string>",
      "realizedPnl": "<string>",
      "realizedPnlBeforeFees": "<string>",
      "payoutAmountUsd": "<string>",
      "eventId": "<string>",
      "marketMetadata": {
        "marketId": "<string>",
        "isTradable": true,
        "title": "<string>",
        "subtitle": "<string>",
        "description": "<string>",
        "status": "<string>",
        "result": "<string>",
        "closeTime": 123,
        "openTime": 123,
        "settlementTime": 123,
        "rulesPrimary": "<string>",
        "rulesSecondary": "<string>",
        "eventId": "<string>"
      },
      "eventMetadata": {
        "eventId": "<string>",
        "title": "<string>",
        "subtitle": "<string>",
        "imageUrl": "<string>",
        "isLive": true
      }
    }
  ],
  "pagination": {
    "start": 1,
    "end": 1,
    "total": 1,
    "hasNext": true
  }
}

Authorizations

x-api-key
string
header
required

Get API key via https://portal.jup.ag

Query Parameters

start
integer | null
Required range: x >= 0
end
integer | null
Required range: x >= 0
ownerPubkey
string

History owner public key

Minimum string length: 32
userPubkey
string

History owner public key (deprecated alias; use ownerPubkey)

Minimum string length: 32
id
integer

History event ID

Required range: x >= 1
positionPubkey
string

Filter by position public key

Minimum string length: 32

Response

200 - application/json

Paginated event history, or single event when id is provided

data
object[]
required
pagination
object
required