Skip to main content
POST
Place limit order

Authorizations

x-app-id
string
header
required

Your application ID. Required for all app-tier and user-tier routes.

Authorization
string
header
required

JWT access token returned by POST /auth/verify. Required for user-tier routes.

Body

application/json
venue
enum<string>
required
Available options:
kalshi,
polymarket,
limitless,
opinion,
predict,
pred,
probable,
myriad,
hyperliquid,
novig,
prophetx
venueMarketOutcomeId
string
required
side
enum<string>
required
Available options:
buy,
sell
limitPriceRaw
string
required
Pattern: ^[1-9][0-9]*$
sizeRaw
string
required
Pattern: ^[1-9][0-9]*$
timeInForce
enum<string>
required
Available options:
GTC,
GTD,
FOK,
FAK,
IOC,
ALO
postOnly
boolean
expiresAt
string<date-time>
clientOrderId
string
Required string length: 1 - 128
approveMode
enum<string>
Available options:
sponsored,
user_broadcast
fundingAddresses
string[]
Required string length: 42
signingAddress
string

Linked account EOA for self-custody; omit for managed custody. Polymarket supports GTC/GTD buys and sells, at or above the market's minimum size, and requires a previously set-up deposit wallet, which makes every order; a legacy Polymarket Safe can top up a buy's pUSD or a sell's shares by moving them into that deposit wallet first (one extra Safe signature), and legacy proxy wallets are not supported. Hyperliquid supports GTC/ALO buys and sells, whole contracts and a 0.00001 price tick, without expiresAt. Hyperliquid order actions are signed by the EOA or its approved client-held agg agent; AGG never holds an agent key. Placement returns quoteId: poll execution status and answer pendingSignatures using each request's signerAddress. Placement is pending until signatures and venue submission finish. Self-custody buys do not reserve managed balances. Funding uses supported balances across chains and the pinned deposit wallet. On a buy, fundingAddresses may add other wallets linked to the same account; their balances fund the order only by bridging in, never on the venue's own chain. Polymarket CLOB credentials are derived in memory per order or signed cancel and never stored; cancelling requires a fresh cancelSignature. Hyperliquid cancellation requires a fresh signed cancel action. An account referenced by an order cannot be disconnected, including after that order becomes terminal.

Required string length: 42

Response

200

orderId
string
required
status
enum<string>
required
Available options:
pending,
open,
partially_filled_open,
filled,
cancelled,
expired,
failed
venue
enum<string>
required
Available options:
kalshi,
polymarket,
limitless,
opinion,
predict,
pred,
probable,
myriad,
hyperliquid,
novig,
prophetx
limitPriceRaw
string
required
limitSizeRaw
string
required
filledSizeRaw
string
required
remainingSizeRaw
string
required
quoteId
string

Execution quote ID for polling GET /execution/status and submitting the user's signatures to POST /execution/fill/:quoteId/signatures. Present for funded buy orders.

venueOrderId
string | null
reservedCostRaw
string | null