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

# Launchpad boards

> `new`: the latest launches, newest first. `graduating`: bonding curve 50–100% full and
traded in the last 30 minutes, fullest first. `graduated`: the latest tokens that moved to
a pool. A token is on one board at a time. Live: channel `launchpad`.


The three columns of a launchpad terminal, on every chain at once or one chain with `chain=`:

| Board | What | Order |
| - | - | - |
| `new` | The latest launches | Newest first |
| `graduating` | Bonding curve 50–100% full, traded in the last 30 minutes | Fullest first |
| `graduated` | The latest tokens that moved to a pool | Newest first |

A token is on one board at a time: it moves to `graduating` when its curve passes 50% (and back if it stops trading for 30 minutes), and to `graduated` when it graduates. Covered launchpads include Pump.fun, Pump Mayhem, LaunchLab, Bonk.fun, Meteora DBC, Moonshot and Bags on Solana, Four.meme and Flap on BNB Chain, and the launchpads of the EVM chains.

Live: the [`launchpad` channel](/streaming/channels#launchpad) sends the board, then `add`, `update` and `remove` as tokens launch, trade and move.


## OpenAPI

````yaml GET /v1/launchpad/{board}
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/launchpad/{board}:
    get:
      tags:
        - discovery
      summary: Launchpad boards
      description: >
        `new`: the latest launches, newest first. `graduating`: bonding curve
        50–100% full and

        traded in the last 30 minutes, fullest first. `graduated`: the latest
        tokens that moved to

        a pool. A token is on one board at a time. Live: channel `launchpad`.
      operationId: getLaunchpadBoard
      parameters:
        - name: board
          in: path
          required: true
          schema:
            type: string
            enum:
              - new
              - graduating
              - graduated
        - name: chain
          in: query
          description: Omit for every chain
          schema:
            type: string
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 200
      responses:
        '200':
          description: Tokens on the board
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/TokenSummary'
              example:
                data:
                  - chain: sol
                    address: GWDPGkHGuCaLPop5fA8goFkZ6ZGygcw8PxKjBxrzZqiK
                    name: Microcat
                    symbol: MICRO
                    image: >-
                      https://ipfs.io/ipfs/bafkreibk5al7quyfgkaoitw3q3eiqkemxt5whoauldk7grk6d4nybstt6q
                    createdAt: 1790813456687
                    creator: ACTMXToQyQ9u7GZUR1ro89gdHJP8GLwtbFw2QJJ7noT9
                    priceUsd: 0.0000048277
                    marketCapUsd: 4827.74
                    liquidityUsd: null
                    holders: 2
                    launchpad:
                      name: Pump.fun
                      progressPercent: 22.24
                      graduated: false
                      graduatedAt: null
                      graduatedPool: null
                    socials:
                      twitter: null
                      telegram: null
                      website: null
                      discord: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    TokenSummary:
      type: object
      description: The short token row of lists (search, launchpad boards).
      properties:
        chain:
          type: string
        address:
          type: string
        name:
          $ref: '#/components/schemas/str'
        symbol:
          $ref: '#/components/schemas/str'
        image:
          $ref: '#/components/schemas/str'
        createdAt:
          $ref: '#/components/schemas/int'
        creator:
          $ref: '#/components/schemas/str'
        priceUsd:
          $ref: '#/components/schemas/num'
        marketCapUsd:
          $ref: '#/components/schemas/num'
        liquidityUsd:
          $ref: '#/components/schemas/num'
        holders:
          $ref: '#/components/schemas/int'
        launchpad:
          $ref: '#/components/schemas/Launchpad'
        socials:
          $ref: '#/components/schemas/Socials'
    str:
      type:
        - string
        - 'null'
    int:
      type:
        - integer
        - 'null'
    num:
      type:
        - number
        - 'null'
    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'
    Socials:
      type: object
      properties:
        twitter:
          $ref: '#/components/schemas/str'
        telegram:
          $ref: '#/components/schemas/str'
        website:
          $ref: '#/components/schemas/str'
        discord:
          $ref: '#/components/schemas/str'
    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'
    NotFound:
      description: Not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: not_found
              message: token not found
  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.