Skip to main content
curl -X POST "https://api.polyhush.com/api/v1/trading/orders" \
     -H "X-API-Key: your-api-key" \
     -H "Content-Type: application/json" \
     -d '{
       "token_id": "12345678901234567890",
       "side": "BUY",
       "shares": 100,
       "price": 0.55,
       "order_type": "GTC"
     }'

​
Request Body

​
token_id
string
required
The outcome token ID to trade.
​
side
string
required
Trade side: "BUY" or "SELL"
​
shares
number
Number of shares to trade.
  • Required for limit orders (GTC)
  • Optional for market orders (can use usdc_amount instead)
​
price
number
Limit price per share (0.01 - 0.99).
  • Required for limit orders (GTC)
  • Ignored for market orders (FOK/FAK)
​
usdc_amount
number
USDC amount to trade. For market orders only.
​
order_type
string
default:"GTC"
Order execution type:
  • GTC - Good Till Cancelled (limit order)
  • FOK - Fill Or Kill (must fully fill or cancel)
  • FAK - Fill And Kill (market order)

​
Response

​
success
boolean
Whether the order was placed successfully.
​
orderID
string
The created order ID.
​
status
string
Order status: live, matched, delayed, unmatched (for market orders), or PLACED, FILLED (for GTC).
​
takingAmount
string
For BUY: shares received. For SELL: USDC received.
​
makingAmount
string
For BUY: USDC spent. For SELL: tokens sold.
​
transactionsHashes
array
Transaction hashes from Polymarket (for filled orders).
​
errorMsg
string
Error message if order failed (optional).
{
  "success": true,
  "orderID": "ord_abc123",
  "status": "live",
  "takingAmount": "0",
  "makingAmount": "55.00",
  "transactionsHashes": []
}

​
Order Types

TypeBehavior
GTCLimit order that sits on the order book until filled or cancelled
FOKMust be completely filled immediately or the entire order is cancelled
FAKMarket order that fills what’s available and cancels the rest
Market orders (FAK) have a minimum order size that varies by market. This value is available from the Polymarket CLOB API.