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

# Top wallets

> The most profitable wallets on a chain over a period.

The most profitable wallets on a chain (default `sol`) over `1d`, `7d` or `30d`, by realized profit unless you sort by `winRate` or `trades`. Rows are [wallet stats](/api-reference/wallets/get); `tags` are free-form labels (`kol`, `smart`, the trading app the wallet uses, …).


## OpenAPI

````yaml GET /v1/wallets/top
openapi: 3.1.0
info:
  title: Raze Market Data API
  version: 1.0.0
  description: >
    Multichain market data for tokens, trades, charts, holders, launchpads and
    wallets on

    Solana, Ethereum, BNB Chain, Base and Robinhood Chain, as REST snapshots and
    live streams.


    **Conventions, everywhere:**

    - Chains: `sol`, `eth`, `bsc`, `base`, `robinhood` (aliases `solana`,
    `ethereum`, `bnb`, `hood` and network ids work too).

    - EVM addresses are answered lowercase; Solana addresses are case-sensitive.

    - Amounts in USD end in `Usd`; percents are 0–100 and end in `Percent`;
    times are Unix **milliseconds**.

    - A value nobody knows is `null`, never `0`.

    - Success: `{"data": …}`, plus `"next"` on paged lists (pass it back as
    `cursor`, as given). A
      page can hold fewer rows than `limit`, even none, and still carry `next`: a list ends only
      where `next` is `null`.
    - Failure: `{"error": {"code", "message"}}` with status 400 (`bad_request`),
    401 (`unauthorized`),
      404 (`not_found`), 429 (`rate_limited`), 502 (`upstream_unavailable`), or 503 with a
      `Retry-After` header (`upstream_unavailable` on a page to ask for again, `server_busy` on a
      new live connection).
    - A Solana address that does not decode to a 32-byte key is a 400 wherever
    one token or wallet
      is named. Lists (`/v1/tokens?ids=`, `/v1/prices?tokens=`) leave out an id that looks like a
      Solana address (32 to 44 base58 characters) but is not a 32-byte key; an id that does not look
      like an address still fails the whole list with 400.

    **Auth:** send your key as `x-api-key`, `Authorization: Bearer <key>`, or
    `?apiKey=` (for

    WebSocket and EventSource, which cannot set headers). `/health` and
    `/v1/openapi.yaml` need no

    key.


    **Live:** one WebSocket at `/v1/ws` carries any number of channels (also at

    `wss://ws.raze.bot`); the same channels are available one per connection as
    Server-Sent Events

    at `/v1/stream/{channel}`. Every channel sends a `snapshot` frame first,
    then changes.
servers:
  - url: https://api.raze.bot
    description: Production
security:
  - ApiKeyHeader: []
  - Bearer: []
  - ApiKeyQuery: []
tags:
  - name: catalog
    description: Health, chains and token search
  - name: tokens
    description: Token snapshot, trades, candles, holders, top traders, image
  - name: discovery
    description: Trending, screener and launchpad boards
  - name: wallets
    description: Wallet leaderboard, stats, holdings, PnL and swaps
  - name: prices
    description: Native coin prices and token prices
  - name: live
    description: WebSocket and Server-Sent Events
paths:
  /v1/wallets/top:
    get:
      tags:
        - wallets
      summary: Top wallets
      description: The most profitable wallets on a chain over a period.
      operationId: getTopWallets
      parameters:
        - name: chain
          in: query
          schema:
            type: string
            default: sol
        - name: period
          in: query
          schema:
            type: string
            enum:
              - 1d
              - 7d
              - 30d
            default: 7d
        - name: sort
          in: query
          schema:
            type: string
            enum:
              - pnl
              - winRate
              - trades
            default: pnl
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 100
      responses:
        '200':
          description: Wallets
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/WalletStats'
              example:
                data:
                  - chain: sol
                    address: 4vw54BmAogeRV3vPKWyFet5yf8DTLcREzdSzx4rw9Ud9
                    period: 7d
                    realizedPnlUsd: 411353.33
                    realizedPnlPercent: 66.28
                    volumeUsd: null
                    trades: 7093
                    buys: 5333
                    sells: 1760
                    winRatePercent: 63.58
                    tokensTraded: null
                    totalPnlUsd: null
                    nativeBalance: 745.64
                    twitter: https://x.com/notdecu
                    tags:
                      - kol
                      - axiom
                      - photon
                    fundedBy: null
                    lastActiveAt: 1790810647000
        '400':
          $ref: '#/components/responses/BadRequest'
components:
  schemas:
    WalletStats:
      type: object
      properties:
        chain:
          type: string
        address:
          type: string
        period:
          type: string
        realizedPnlUsd:
          $ref: '#/components/schemas/num'
        realizedPnlPercent:
          $ref: '#/components/schemas/num'
        volumeUsd:
          $ref: '#/components/schemas/num'
        trades:
          $ref: '#/components/schemas/int'
        buys:
          $ref: '#/components/schemas/int'
        sells:
          $ref: '#/components/schemas/int'
        winRatePercent:
          $ref: '#/components/schemas/num'
        tokensTraded:
          $ref: '#/components/schemas/int'
        totalPnlUsd:
          $ref: '#/components/schemas/num'
          description: Lifetime
        nativeBalance:
          $ref: '#/components/schemas/num'
          description: In the chain's coin
        twitter:
          $ref: '#/components/schemas/str'
        tags:
          type: array
          items:
            type: string
        fundedBy:
          $ref: '#/components/schemas/str'
        lastActiveAt:
          $ref: '#/components/schemas/int'
    num:
      type:
        - number
        - 'null'
    int:
      type:
        - integer
        - 'null'
    str:
      type:
        - string
        - 'null'
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - unauthorized
                - not_found
                - rate_limited
                - upstream_unavailable
                - server_busy
            message:
              type: string
  responses:
    BadRequest:
      description: A parameter is missing or wrong
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: bad_request
              message: 'unknown chain ''xyz'', use one of: sol, eth, bsc, base, robinhood'
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
    Bearer:
      type: http
      scheme: bearer
    ApiKeyQuery:
      type: apiKey
      in: query
      name: apiKey

````

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