POST
/
v1
/
predictions
/
polymarket
/
orders
Place Order
curl --request POST \
  --url https://api.example.com/v1/predictions/polymarket/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "tokenId": "<string>",
  "side": "<string>",
  "type": "<string>",
  "size": "<string>",
  "price": "<string>",
  "apiKey": "<string>",
  "apiSecret": "<string>",
  "passphrase": "<string>"
}
'

​
Upstream Mapping

Maps to Polymarket’s CLOB POST /order endpoint.

​
Request

​
Body Parameters

​
tokenId
string
required
Outcome token ID to trade
​
side
string
required
buy or sell
​
type
string
required
limit or market
​
size
string
required
Order size in USDC
​
price
string
Limit price (0 to 1). Required for limit orders.
​
apiKey
string
required
Your Polymarket API key
​
apiSecret
string
required
Your Polymarket API secret
​
passphrase
string
required
Your Polymarket passphrase

​
Example

curl -X POST -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  https://api.perps.studio/v1/predictions/polymarket/orders \
  -d '{
    "tokenId": "71234",
    "side": "buy",
    "type": "limit",
    "size": "100",
    "price": "0.70",
    "apiKey": "your-poly-api-key",
    "apiSecret": "your-poly-secret",
    "passphrase": "your-passphrase"
  }'
Example Response
{
  "orderId": "order-xyz-123",
  "status": "open",
  "tokenId": "71234",
  "side": "buy",
  "type": "limit",
  "size": "100",
  "price": "0.70",
  "filledSize": "0"
}

​
Errors

StatusCodeDescription
400INVALID_ORDERInvalid order parameters
401INVALID_API_KEYMissing Provider API key
401SIGNATURE_ERRORInvalid Polymarket credentials
422ORDER_REJECTEDOrder rejected by Polymarket