Skip to main content
POST
/
orders
cURL
curl --request POST \
  --url https://api.jup.ag/prediction/v1/orders \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "isBuy": true,
  "ownerPubkey": "<string>",
  "userPubkey": "<string>",
  "marketId": "<string>",
  "positionPubkey": "<string>",
  "isYes": true,
  "contracts": "<string>",
  "maxBuyPriceUsd": "<string>",
  "minSellPriceUsd": "<string>",
  "depositAmount": "<string>",
  "depositMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
}
'
{
  "transaction": "<string>",
  "txMeta": {
    "blockhash": "<string>",
    "lastValidBlockHeight": 1
  },
  "externalOrderId": "<string>",
  "order": {
    "orderPubkey": "<string>",
    "orderAtaPubkey": "<string>",
    "userPubkey": "<string>",
    "marketId": "<string>",
    "marketIdHash": "<string>",
    "positionPubkey": "<string>",
    "isBuy": true,
    "isYes": true,
    "contracts": "<string>",
    "newContracts": "<string>",
    "maxBuyPriceUsd": "<string>",
    "minSellPriceUsd": "<string>",
    "externalOrderId": "<string>",
    "orderCostUsd": "<string>",
    "newAvgPriceUsd": "<string>",
    "newSizeUsd": "<string>",
    "newPayoutUsd": "<string>",
    "estimatedProtocolFeeUsd": "<string>",
    "estimatedVenueFeeUsd": "<string>",
    "estimatedTotalFeeUsd": "<string>"
  }
}

Authorizations

x-api-key
string
header
required

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

Body

application/json
isBuy
boolean
required
ownerPubkey
string

Order owner public key

userPubkey
string

Order owner public key (deprecated alias; use ownerPubkey)

marketId
string

Hashed or canonical market ID for buys

Minimum string length: 1
positionPubkey
string

Required for sells

Minimum string length: 32
isYes
boolean
contracts
maxBuyPriceUsd

Must be between 10000 ($0.01) to 999999 ($0.99)

minSellPriceUsd

Must be between 10000 ($0.01) to 999999 ($0.99)

depositAmount

Amount must conform to the token decimals used by the token mint in depositMint

depositMint
string
default:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Mint address for the deposit token

Response

Unsigned transaction for creating an order

transaction
string | null
required

Base64 encoded transaction

txMeta
object
required

Transaction metadata

externalOrderId
string | null
required
order
object
required