Trading

Create a durable, reviewable live-trade run

Save a validated order plan. This endpoint cannot submit an order.

post/trading/runs

Request

  • Base URL: https://foresea.ink (the document declares no server; this is the origin it was published from)
  • URL: https://foresea.ink/trading/runs
  • 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.

titlestring

Short operator-facing name for this run.

thesisstring

Optional research rationale retained with the trade run.

source_conversation_idstring nullable

Optional chat thread that produced the trade idea.

expected_edgenumber nullable

Optional model-minus-market probability edge.

sourcesstring[]

Optional source URLs or identifiers supporting the thesis.

Response

Successful Response

idstring required
statusstring required
titlestring required
platformstring required
actionstring required
outcomestring required
tickerstring nullable
token_idstring nullable
quantitynumber nullable
pricenumber nullable
estimated_notionalnumber nullable
order_typestring nullable
client_order_idstring nullable
previewobject required
provenanceobject required
audit_order_idstring nullable
venue_order_idstring nullable
reconciliation_statusstring nullable
approved_atstring nullable
submitted_atstring nullable
last_reconciled_atstring nullable
created_atstring required
updated_atstring required
error_codestring nullable

Changes

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