POST /execute

Polymarket trades are proxied to the execution service; Kalshi trades are handled in-process. Live mode (mode="live") requires a Privy wallet-auth JWT in the Authorization header. See API_REFERENCE.md §7.1 for the full SSE event reference.

Authorization

privy

AuthorizationBearer <token>

Privy access token. For live POST /execute, use the wallet-auth JWT instead.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

marketId*string

venueMarketId?string

side*string

Value in"buy" | "sell"

outcome*string

Value in"yes" | "no"

size*number

Range0 <= value

limitPrice?number

Range0 <= value <= 1

orderType?string

Value in"limit" | "market"

mode?string

Value in"simulation" | "live"

venue?string

Value in"polymarket" | "kalshi"

pearId?string

fundingSourceChain?string

Value in"polygon" | "solana"

fundingSourceCurrency?string

fundingAmountAtomic?string

referrerId?string

eventTitle?string

marketTitle?string

eventSlug?string

category?string

Response Body

`text/event-stream`

curl -X POST "https://api.pear.trade/execute" \  -H "Content-Type: application/json" \  -d '{    "marketId": "string",    "side": "buy",    "outcome": "yes",    "size": 0  }'

Empty

Authorization

Request Body

Response Body

200text/event-stream

400

401

502

503

`text/event-stream`