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>",
  "marketId": "<string>",
  "positionPubkey": "<string>",
  "isYes": true,
  "contracts": "<string>",
  "contractsMicro": "<string>",
  "contractsDecimal": "<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>",
    "contractsMicro": "<string>",
    "contractsDecimal": "<string>",
    "newContractsMicro": "<string>",
    "newContractsDecimal": "<string>",
    "payoutUsd": "<string>",
    "slippageBps": 1,
    "maxSlippageBps": 1
  },
  "requiredSigners": [
    "<string>"
  ]
}

Authorizations

x-api-key
string
header
required

Body

application/json
isBuy
boolean
required
ownerPubkey
string

Order owner public key

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

Legacy whole-contract sell quantity (only when isBuy is false). Cannot express fractions; prefer contractsMicro or contractsDecimal. Provide only one of contracts, contractsMicro, or contractsDecimal.

contractsMicro

Exact sell quantity in micro-contract units (1000000 = 1 contract). Provide only one of contracts, contractsMicro, or contractsDecimal.

contractsDecimal

Exact sell quantity as a decimal (e.g. 5.777773). Provide only one of contracts, contractsMicro, or contractsDecimal.

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
requiredSigners
string[]

Public keys that must sign the returned transaction