Trader Orders

Retrieve a granular list of every order a trader placed within a single market. Each record includes execution timing, outcome, side, price, size, and maker/taker status, giving you deep insight into their trading strategy for that market.

GET /v1/traders/:address/markets/:id/orders

string

required

Your PolyEdge API key.

Parameters

string

required

The EVM wallet address of the trader.

integer

required

The unique numeric ID of the market (int64).

Response

object[]

Array of individual order executions for the trader in this market, ordered by time.

Show properties

string

ISO 8601 timestamp of when the order was executed.

string

The outcome the order was placed on (e.g., Rockets, Warriors).

string

Order direction. Either BUY or SELL.

string

Execution price in micro-units (6 decimal places). Divide by 1,000,000 to get the price in cents (0–100 scale).

string

Number of shares filled, in micro-units.

string

USDC value of the order, in micro-USDC (6 decimal places).

string

Unique on-chain hash identifying this order.

boolean

true if the trader was the taker (market order); false if they were the maker (limit order).

string

Fee in micro-USDC (6 decimal places).

string

The ERC-1155 token ID representing the outcome share being traded.

Example

curl https://api.polyedge.dev/v1/traders/0x8a6c6811e8937f9e8afc1b9249fa540262c30b3f/markets/1858809/orders \
  -H "X-PolyEdge-Key: YOUR_API_KEY"

{
  "orders": [
    {
      "time": "2026-04-06T02:25:29Z",
      "outcome": "Rockets",
      "side": "BUY",
      "price": "478541",
      "shares": "10448408978",
      "usdc": "4999999999",
      "order_hash": "0x25150adb61c78c2fe4bf9a025ad1b9fac0bf9cbb3a8904c74430905cb2a008ce",
      "is_taker": true,
      "fee": "24999999",
      "token_id": "78907585036215681443680219168838316352537740030793428756821532285400412083533"
    },
    {
      "time": "2026-04-06T02:25:41Z",
      "outcome": "Rockets",
      "side": "BUY",
      "price": "490377",
      "shares": "10196233400",
      "usdc": "5000000000",
      "order_hash": "0xd28535f6a2f61e67bc193db8d485469b3169aaaeba1e107fb04aea7075fcd5de",
      "is_taker": true,
      "fee": "25000000",
      "token_id": "78907585036215681443680219168838316352537740030793428756821532285400412083533"
    },
    {
      "time": "2026-04-06T02:25:55Z",
      "outcome": "Rockets",
      "side": "BUY",
      "price": "491157",
      "shares": "10180037400",
      "usdc": "5000000000",
      "order_hash": "0xe69fee7a435b843262dbfc90efb9fb5ad3eb5c5705ea3e4fd1bc8c67c786ab4f",
      "is_taker": true,
      "fee": "25000000",
      "token_id": "78907585036215681443680219168838316352537740030793428756821532285400412083533"
    }
  ]
}

Analytics

Traders

Markets

Streaming

Parameters

Response

Example

​Parameters

​Response

​Example

Parameters

Response

Example