> ## 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.

# Get token

> Everything about one token: identity, price, market cap, liquidity, holders, 1m–24h stats,
main pool, launchpad and safety. `404` when no source knows the token.


One call for a token page: identity, socials, supply, price, market cap (`priceUsd × circulatingSupply`), liquidity, holders, stats over `1m`, `5m`, `1h`, `6h` and `24h`, the main pool, the launchpad and safety.

* `launchpad` is `null` for a token that never was on one. While on the curve, `progressPercent` is the fill (0–100); after graduation `graduated` is `true` and `graduatedPool` the pool it moved to.
* `safety` fields that are `null` are unknown, not clean: never render them as a green check.
* **404** means no source knows the token. **502** means a source did not answer: retry, do not treat it as "does not exist".

Live: the [`token` channel](/streaming/channels#token) sends a price tick on every trade and this object again every 15 s while it trades.


## OpenAPI

````yaml GET /v1/tokens/{chain}/{address}
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/tokens/{chain}/{address}:
    get:
      tags:
        - tokens
      summary: Get a token
      description: >
        Everything about one token: identity, price, market cap, liquidity,
        holders, 1m–24h stats,

        main pool, launchpad and safety. `404` when no source knows the token.
      operationId: getToken
      parameters:
        - $ref: '#/components/parameters/chain'
        - $ref: '#/components/parameters/address'
      responses:
        '200':
          description: Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Token'
              examples:
                bonk:
                  $ref: '#/components/examples/Token'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '502':
          $ref: '#/components/responses/Upstream'
components:
  parameters:
    chain:
      name: chain
      in: path
      required: true
      description: '`sol`, `eth`, `bsc`, `base` or `robinhood` (or an alias or network id)'
      schema:
        type: string
        example: sol
    address:
      name: address
      in: path
      required: true
      description: Token address (mint or contract)
      schema:
        type: string
        example: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
  schemas:
    Token:
      type: object
      properties:
        chain:
          type: string
        address:
          type: string
        name:
          $ref: '#/components/schemas/str'
        symbol:
          $ref: '#/components/schemas/str'
        decimals:
          $ref: '#/components/schemas/int'
        image:
          $ref: '#/components/schemas/str'
        banner:
          $ref: '#/components/schemas/str'
        description:
          $ref: '#/components/schemas/str'
        socials:
          $ref: '#/components/schemas/Socials'
        createdAt:
          $ref: '#/components/schemas/int'
        creator:
          $ref: '#/components/schemas/str'
        totalSupply:
          $ref: '#/components/schemas/num'
          description: Whole tokens
        circulatingSupply:
          $ref: '#/components/schemas/num'
          description: Whole tokens
        priceUsd:
          $ref: '#/components/schemas/num'
        marketCapUsd:
          $ref: '#/components/schemas/num'
          description: price × circulating supply
        liquidityUsd:
          $ref: '#/components/schemas/num'
        holders:
          $ref: '#/components/schemas/int'
        stats:
          type: object
          properties:
            1m:
              $ref: '#/components/schemas/Window'
            5m:
              $ref: '#/components/schemas/Window'
            1h:
              $ref: '#/components/schemas/Window'
            6h:
              $ref: '#/components/schemas/Window'
            24h:
              $ref: '#/components/schemas/Window'
        pool:
          $ref: '#/components/schemas/Pool'
        launchpad:
          $ref: '#/components/schemas/Launchpad'
        safety:
          oneOf:
            - $ref: '#/components/schemas/Safety'
            - type: 'null'
    str:
      type:
        - string
        - 'null'
    int:
      type:
        - integer
        - 'null'
    Socials:
      type: object
      properties:
        twitter:
          $ref: '#/components/schemas/str'
        telegram:
          $ref: '#/components/schemas/str'
        website:
          $ref: '#/components/schemas/str'
        discord:
          $ref: '#/components/schemas/str'
    num:
      type:
        - number
        - 'null'
    Window:
      type: object
      description: Activity over one window.
      properties:
        priceChangePercent:
          $ref: '#/components/schemas/num'
        volumeUsd:
          $ref: '#/components/schemas/num'
        buyVolumeUsd:
          $ref: '#/components/schemas/num'
        sellVolumeUsd:
          $ref: '#/components/schemas/num'
        buys:
          $ref: '#/components/schemas/int'
        sells:
          $ref: '#/components/schemas/int'
        trades:
          $ref: '#/components/schemas/int'
    Pool:
      type:
        - object
        - 'null'
      description: The token's main pool.
      properties:
        address:
          type: string
        dex:
          $ref: '#/components/schemas/str'
        quoteToken:
          $ref: '#/components/schemas/str'
        quoteSymbol:
          $ref: '#/components/schemas/str'
        liquidityUsd:
          $ref: '#/components/schemas/num'
    Launchpad:
      type:
        - object
        - 'null'
      description: '`null` when the token never was on a launchpad.'
      properties:
        name:
          $ref: '#/components/schemas/str'
          description: >-
            Pump.fun, Pump Mayhem, LaunchLab, Bonk.fun, MeteoraDBC, Moonshot,
            Bags, Four.meme, Flap, …
        progressPercent:
          $ref: '#/components/schemas/num'
          description: Bonding curve fill, 0–100; null once graduated
        graduated:
          type: boolean
        graduatedAt:
          $ref: '#/components/schemas/int'
        graduatedPool:
          $ref: '#/components/schemas/str'
    Safety:
      type: object
      description: >-
        Shares of supply or of holders, in percent, and contract checks. `null`
        fields are unknown, not clean.
      properties:
        top10Percent:
          $ref: '#/components/schemas/num'
        devPercent:
          $ref: '#/components/schemas/num'
        snipersPercent:
          $ref: '#/components/schemas/num'
        bundlersPercent:
          $ref: '#/components/schemas/num'
        insidersPercent:
          $ref: '#/components/schemas/num'
        botsPercent:
          $ref: '#/components/schemas/num'
        freshWalletsPercent:
          $ref: '#/components/schemas/num'
        bluechipPercent:
          $ref: '#/components/schemas/num'
        creatorLaunches:
          $ref: '#/components/schemas/int'
          description: Tokens the creator launched
        honeypot:
          type:
            - boolean
            - 'null'
        mintRenounced:
          type:
            - boolean
            - 'null'
        freezeRenounced:
          type:
            - boolean
            - 'null'
        buyTaxPercent:
          $ref: '#/components/schemas/num'
        sellTaxPercent:
          $ref: '#/components/schemas/num'
    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
  examples:
    Token:
      summary: Bonk on Solana
      value:
        data:
          chain: sol
          address: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
          name: Bonk
          symbol: Bonk
          decimals: 5
          image: >-
            https://gmgn.ai/external-res/4347f4c4d1e865bd04c0ed7dd4abbafb_v2.webp
          banner: https://gmgn.ai/external-res/ba6d01a031fc028efe5b0acbcfb8cc13.webp
          description: null
          socials:
            twitter: https://x.com/bonk_inu
            telegram: https://t.me/Official_Bonk_Inu
            website: https://www.bonkcoin.com
            discord: null
          createdAt: 1670531612000
          creator: null
          totalSupply: 87994377287740
          circulatingSupply: 87994377287740
          priceUsd: 0.0000037768409
          marketCapUsd: 332340763.11
          liquidityUsd: 305509.85
          holders: 1011844
          stats:
            1m:
              priceChangePercent: -0.05
              volumeUsd: 1126.58
              buyVolumeUsd: 230.04
              sellVolumeUsd: 896.54
              buys: 30
              sells: 24
              trades: 54
            5m:
              priceChangePercent: -0.24
              volumeUsd: 2795.81
              buyVolumeUsd: 780.27
              sellVolumeUsd: 2015.53
              buys: 42
              sells: 57
              trades: 99
            1h:
              priceChangePercent: -0.9
              volumeUsd: 52297.54
              buyVolumeUsd: 22963.56
              sellVolumeUsd: 29333.98
              buys: 434
              sells: 559
              trades: 993
            6h:
              priceChangePercent: -0.29
              volumeUsd: 370568.63
              buyVolumeUsd: 187256.1
              sellVolumeUsd: 183312.53
              buys: 4399
              sells: 4447
              trades: 8846
            24h:
              priceChangePercent: 3.98
              volumeUsd: 2948567.18
              buyVolumeUsd: 1499353.96
              sellVolumeUsd: 1449213.22
              buys: 34362
              sells: 31693
              trades: 66055
          pool:
            address: 5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9
            dex: orca
            quoteToken: So11111111111111111111111111111111111111112
            quoteSymbol: SOL
            liquidityUsd: 305509.85
          launchpad: null
          safety:
            top10Percent: 31.83
            devPercent: 0
            snipersPercent: 0.00003
            bundlersPercent: 0.21
            insidersPercent: 0.06
            botsPercent: 0.02
            freshWalletsPercent: 0.02
            bluechipPercent: 0
            creatorLaunches: 0
            honeypot: null
            mintRenounced: null
            freezeRenounced: null
            buyTaxPercent: null
            sellTaxPercent: null
  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'
    NotFound:
      description: Not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: not_found
              message: token not found
    Upstream:
      description: The data source did not answer; retry with backoff
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  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.