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

# Market Top Traders

> Ranked traders of a single market (pool) over a rolling window: net native PnL, tokens and native bought/sold, open position, average entry, first/last trade, and dev/sniper/pro-trader badges. Same engine as token top traders, scoped to one pool.

`GET /v1/pool/top-traders` · **2 credits**

Ranked traders of a single market (pool) over a rolling window: net native PnL, tokens and native bought/sold, open position, average entry, first/last trade, and dev/sniper/pro-trader badges. Same engine as [Token Top Traders](/endpoints/token-top-traders), scoped to one pool. EVM and Solana, one shape.

<Note>`meta` echoes the resolved `timeframe`, `sortBy` and `order`, plus `usdBasis` - the basis of every USD figure in the response.</Note>

<Note>`realizedPnlNative` is each trader's net native cashflow over the window (sold − bought); `winRatePct`, `positionValue*`, `unrealizedPnl*` and `totalPnl*` are `null` on windowed rankings. For lifetime PnL, win rate and the current bag's value, use [Token Top Traders](/endpoints/token-top-traders) with `timeframe=all`. On Solana (`usdBasis` `trade`), `boughtUsd`, `soldUsd` and `realizedPnlUsd` are valued at the SOL price at the time of each trade; on EVM chains (`usdBasis` `spot`), native amounts are converted at the current native price; `meta.traderCount` is the number of distinct wallets in the window.</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.serialized.xyz/v1/pool/top-traders?chain=evm:8453&address=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&timeframe=1d&limit=3' \
    -H 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "rank": 1,
        "address": "0x16380ab7951906dd53ca6095d51f091ef2614127",
        "buys": 11,
        "sells": 6,
        "boughtTokens": "48210339.5",
        "soldTokens": "40118207.1",
        "boughtNative": 1.740221,
        "soldNative": 2.994518,
        "boughtUsd": 3271.62,
        "soldUsd": 5629.69,
        "openTokens": "8092132.4",
        "positionValueNative": null,
        "positionValueUsd": null,
        "unrealizedPnlNative": null,
        "unrealizedPnlUsd": null,
        "totalPnlNative": null,
        "totalPnlUsd": null,
        "realizedPnlNative": 1.254297,
        "realizedPnlUsd": 2358.32,
        "avgBuyPriceNative": 0.0000000361,
        "winRatePct": null,
        "isDev": false,
        "isSniper": true,
        "isProTrader": true,
        "firstTradeAt": 1786820044000,
        "lastTradeAt": 1786901550000
      },
      {
        "rank": 2,
        "address": "0x9773c9e7d048ae91a4fd9a48cd0b984e31fa418c",
        "buys": 4,
        "sells": 4,
        "boughtTokens": "20110004.0",
        "soldTokens": "20110004.0",
        "boughtNative": 0.712004,
        "soldNative": 1.188771,
        "boughtUsd": 1338.57,
        "soldUsd": 2234.89,
        "openTokens": "0",
        "positionValueNative": null,
        "positionValueUsd": null,
        "unrealizedPnlNative": null,
        "unrealizedPnlUsd": null,
        "totalPnlNative": null,
        "totalPnlUsd": null,
        "realizedPnlNative": 0.476767,
        "realizedPnlUsd": 896.51,
        "avgBuyPriceNative": 0.0000000354,
        "winRatePct": null,
        "isDev": false,
        "isSniper": false,
        "isProTrader": null,
        "firstTradeAt": 1786841201000,
        "lastTradeAt": 1786899330000
      }
    ],
    "meta": {
      "asOf": 1786901933078,
      "usdBasis": "spot",
      "sortBy": "pnl",
      "order": "desc",
      "timeframe": "1d",
      "traderCount": 231
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi.json GET /v1/pool/top-traders
openapi: 3.1.0
info:
  title: Serialized Data API
  description: >-
    On-chain data for trading apps - tokens, candles, token filters. Built on
    our own indexers. 18 EVM chains + Solana, live.
  version: 0.1.0
servers:
  - url: https://demo.serialized.xyz
    description: 'Demo: no key needed, read endpoints, rate-limited per IP'
  - url: https://api.serialized.xyz
    description: 'Production: your API key in the Authorization header'
security:
  - apiKey: []
  - {}
paths:
  /v1/pool/top-traders:
    get:
      summary: Market Top Traders
      description: >-
        Ranked traders of a single market (pool) over a rolling window: net PnL
        in native and USD, tokens and native bought/sold, open position, average
        entry, first/last trade, and dev/sniper/pro-trader badges. Same engine
        as Token Top Traders, scoped to one pool. EVM and Solana, one shape.
      operationId: pool-top-traders
      parameters:
        - schema:
            type: string
            x-default: evm:8453
          in: query
          name: chain
          required: true
          description: Public chain id - `evm:<id>` or `solana`.
          example: evm:8453
        - schema:
            type: string
            x-default: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
          in: query
          name: address
          required: true
          description: >-
            Pool / pair address (the stable market id on its chain - Uniswap V4
            poolIds supported).
          example: '0x0ca6485b7e9cf814a3fd09d81672b07323535b64'
        - schema:
            default: 1d
            anyOf:
              - type: string
                enum:
                  - 1h
              - type: string
                enum:
                  - 4h
              - type: string
                enum:
                  - 1d
              - type: string
                enum:
                  - 7d
              - type: string
                enum:
                  - 30d
            x-default: 1d
          in: query
          name: timeframe
          required: false
          description: 'Rolling window: `1h`, `4h`, `1d` (default), `7d` or `30d`.'
          example: 1d
        - schema:
            anyOf:
              - type: string
                enum:
                  - pnl
              - type: string
                enum:
                  - bought
              - type: string
                enum:
                  - sold
              - type: string
                enum:
                  - txns
          in: query
          name: sortBy
          required: false
          description: '`pnl` (default), `bought`, `sold` or `txns`.'
        - schema:
            anyOf:
              - type: string
                enum:
                  - asc
              - type: string
                enum:
                  - desc
          in: query
          name: order
          required: false
          description: '`desc` (default) or `asc`.'
        - schema:
            minimum: 1
            maximum: 100
            default: 20
            type: integer
            x-default: 2
          in: query
          name: limit
          required: false
          description: 1-100. Default 20.
          example: 2
      responses:
        '200':
          description: Standard `{ data, meta }` envelope.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header
      description: Your raw API key (not needed on the demo server).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.