Watch Trades

Watch trade executions in real-time via WebSocket. Returns a promise that resolves with the next trade(s). Call repeatedly in a loop to stream updates (CCXT Pro pattern).

POST /api/{exchange}/watchTrades

cURL

Interactive Example

curl --request POST \
  --url https://api.pmxt.dev/api/{exchange}/watchTrades \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "args": [
    "<string>"
  ],
  "credentials": {
    "apiKey": "<string>",
    "apiSecret": "<string>",
    "passphrase": "<string>",
    "apiToken": "<string>",
    "privateKey": "<string>",
    "signatureType": 123,
    "funderAddress": "<string>"
  }
}
'

200

{
  "success": true,
  "error": {
    "message": "<string>"
  },
  "data": [
    {
      "id": "<string>",
      "timestamp": 123,
      "price": 123,
      "amount": 123,
      "side": "buy",
      "outcomeId": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Required when calling the hosted API directly (curl, requests, fetch). SDK users pass credentials via constructor params instead.

Path Parameters

exchange · enum<string> · required

The prediction market exchange to target.

Available options: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us

Body

application/json

args · string · string · number · number[] · required

Required array length: 1 - 4 elements

credentials · object

Optional authentication credentials for exchange operations.

Show child attributes

Response

200 - application/json

Watch Trades response

success · boolean

Example:

true

error · object

Show child attributes

data · object[]

Show child attributes