> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polyedge.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Trader Orders

> Retrieve all individual orders placed by a trader within a specific market.

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
```

<ParamField header="X-PolyEdge-Key" type="string" required>
  Your PolyEdge API key.
</ParamField>

## Parameters

<ParamField path="address" type="string" required>
  The EVM wallet address of the trader.
</ParamField>

<ParamField path="id" type="integer" required>
  The unique numeric ID of the market (`int64`).
</ParamField>

## Response

<ResponseField name="orders" type="object[]">
  Array of individual order executions for the trader in this market, ordered by time.

  <Expandable title="properties">
    <ResponseField name="time" type="string">
      ISO 8601 timestamp of when the order was executed.
    </ResponseField>

    <ResponseField name="outcome" type="string">
      The outcome the order was placed on (e.g., `Rockets`, `Warriors`).
    </ResponseField>

    <ResponseField name="side" type="string">
      Order direction. Either `BUY` or `SELL`.
    </ResponseField>

    <ResponseField name="price" type="string">
      Execution price in micro-units (6 decimal places). Divide by 1,000,000 to get the price in cents (0–100 scale).
    </ResponseField>

    <ResponseField name="shares" type="string">
      Number of shares filled, in micro-units.
    </ResponseField>

    <ResponseField name="usdc" type="string">
      USDC value of the order, in micro-USDC (6 decimal places).
    </ResponseField>

    <ResponseField name="order_hash" type="string">
      Unique on-chain hash identifying this order.
    </ResponseField>

    <ResponseField name="is_taker" type="boolean">
      `true` if the trader was the taker (market order); `false` if they were the maker (limit order).
    </ResponseField>

    <ResponseField name="fee" type="string">
      Fee in micro-USDC (6 decimal places).
    </ResponseField>

    <ResponseField name="token_id" type="string">
      The ERC-1155 token ID representing the outcome share being traded.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash theme={null}
curl https://api.polyedge.dev/v1/traders/0x8a6c6811e8937f9e8afc1b9249fa540262c30b3f/markets/1858809/orders \
  -H "X-PolyEdge-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "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"
    }
  ]
}
```