Trading

Submit a confirmed prediction-market order

Submit a live order after preview guardrails and exact confirmation.

Live execution is disabled unless FORESEA_ENABLE_BYO_TRADING=true. Market/IOC style orders are separately disabled unless FORESEA_ALLOW_MARKET_ORDERS=true.

post/trading/orders

Request

  • Base URL: https://foresea.ink (the document declares no server; this is the origin it was published from)
  • URL: https://foresea.ink/trading/orders
  • Auth: none declared

Request body

platformstring required

kalshi or polymarket.

actionstring

buy or sell.

outcomestring

Outcome side: yes or no.

order_typestring

limit or market.

pricenumber nullable

Limit price, or worst acceptable price for market/IOC-style orders.

quantitynumber required

Contracts/shares. For Polymarket market-buy, max_cost may define spend.

max_costnumber nullable

Polymarket market-buy spend cap in USD.

tickerstring nullable

Kalshi market ticker.

token_idstring nullable

Polymarket CLOB outcome token id.

slugstring nullable

Polymarket market slug for token resolution.

market_idstring nullable

Polymarket market id for token resolution.

time_in_forcestring nullable

Venue-specific TIF, e.g. GTC/FOK or good_till_canceled.

post_onlyboolean

Reject rather than cross the book when supported.

reduce_onlyboolean

Kalshi reduce-only flag.

tick_sizestring nullable

Polymarket tick size override.

neg_riskboolean nullable

Polymarket negative-risk market flag.

client_order_idstring nullable

Caller-provided idempotency/order id.

cancel_order_on_pauseboolean

Kalshi cancel-on-pause flag.

subaccountinteger nullable

Kalshi subaccount number.

exchange_indexinteger

Kalshi exchange shard index; currently 0.

executeboolean

Must be true on /trading/orders for live execution.

confirmationstring nullable

Must equal the server confirmation phrase.

Response

Successful Response

okboolean required
platformstring required
would_executeboolean required
requires_confirmationboolean required
confirmation_phrasestring required
trading_enabledboolean required
max_order_notionalnumber required
estimated_notionalnumber required
warningsstring[]
normalized_orderobject required
submittedboolean required
user_idstring required
venue_responseobject required
audit_order_idstring nullable
venue_order_idstring nullable
reconciliation_statusstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.