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

# Trades by token mint



## OpenAPI

````yaml openapi-spec/history.yaml get /api/sol/trades/mint/{mint}
openapi: 3.0.3
info:
  title: Raze Database API
  description: >
    Paid subscription API for Solana transaction data and history.


    Also hosts write utilities (`/utils/sol/*`): token launch, transfer, burn,

    consolidate, fees claim/config, and agent initialize — previously on

    `router.raze.bot`. Mixer/distribute removed 2026-07-25.


    ## Batch Requests

    All endpoints with path parameters (mint, signer, address, tokenMint,
    ownerAddress) support batch queries

    via comma-separated values. For example:
    `/api/sol/trades/mint/mint1,mint2,mint3?limit=50`


    - Maximum 10 values per batch request

    - Each value must be a valid address (>= 32 characters)

    - Single values behave identically to non-batch requests

    - Batch response format: `{ "success": true, "results": { "value1": {...},
    "value2": {...} }, "count": N, "timestamp": "..." }`

    - Each key in `results` contains the full single-entity response

    - Queries run in parallel for maximum performance
  version: 1.0.0
servers:
  - url: https://api.raze.bot
    description: >-
      Raze global History API — GeoDNS routes to the nearest region
      automatically
security:
  - ApiKeyAuth: []
paths:
  /api/sol/trades/mint/{mint}:
    get:
      summary: Trades by token mint
      operationId: getTradesByMint
      parameters:
        - name: mint
          in: path
          required: true
          schema:
            type: string
          example: Fyx78ew4wRY26gPj5CkTyuZ4kvW7CkPff5Jm2vNspump
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 50
          description: Maximum number of trades to return
        - name: cursor
          in: query
          schema:
            type: string
          description: >-
            Cursor for efficient pagination. Use the nextCursor value from the
            previous response to fetch the next page.
        - name: from
          in: query
          schema:
            type: integer
            format: int64
          description: >-
            Inclusive lower bound of the time window, in Unix MILLISECONDS.
            (Note - ms, unlike OHLC which uses seconds.)
        - name: to
          in: query
          schema:
            type: integer
            format: int64
          description: Inclusive upper bound of the time window, in Unix MILLISECONDS.
        - name: sort
          in: query
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
          description: >-
            Sort order by timestamp. Use 'asc' for oldest first, 'desc' for
            newest first (default)
      responses:
        '200':
          description: >
            Success. Each `data[]` item is a mint-scoped Trade (includes the
            enriched

            quote/venue/liquidity block). An invalid address returns HTTP 200
            with

            `{ "error": true, "message": "..." }` rather than a 4xx status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradesResponse'
        '500':
          description: Database error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TradesResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/Trade'
        count:
          type: integer
          description: Number of trades returned in this response
        limit:
          type: integer
          description: Maximum number of trades requested
        nextCursor:
          type: string
          nullable: true
          description: >-
            Cursor to use for fetching the next page of results. Pass this value
            to the cursor parameter in your next request. Returns null when no
            more pages are available.
        hasMore:
          type: boolean
          description: Indicates if there are more records available
        mint:
          type: string
          description: Present when filtering by mint
        signer:
          type: string
          description: Present when filtering by signer
        sort:
          type: string
          enum:
            - asc
            - desc
          description: >-
            Sort order used for the query (asc = oldest first, desc = newest
            first)
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        code:
          type: string
        success:
          type: boolean
      example:
        error: Unauthorized
        message: Invalid API key
        code: INVALID_KEY
        success: false
    Trade:
      type: object
      properties:
        signature:
          type: string
        timestamp:
          type: string
          format: date-time
        tokenMint:
          type: string
        signer:
          type: string
        transactionType:
          type: string
          enum:
            - buy
            - sell
        solAmount:
          type: string
          description: >
            SOL units. USDC-quoted pools are normalised via the live SOL/USD
            price hook so this field stays SOL-denominated for retrocompat. See
            `quoteAmount` for the native quote.
        solAmountUSD:
          type: string
        tokensAmount:
          type: string
        avgPrice:
          type: string
          description: Per-token SOL price. Always SOL-denominated.
        avgPriceUSD:
          type: string
        fee:
          type: string
        slot:
          type: integer
        proTrade:
          type: boolean
        isBundle:
          type: boolean
        isSniper:
          type: boolean
        analysisUpdatedAt:
          type: string
          nullable: true
          description: >
            Timestamp of the most recent sniper/bundle/pro-trader analysis pass
            for this trade, or `null` if not yet analysed. Returned on both
            mint-scoped and signer-scoped queries.
        createdAt:
          type: string
          description: >
            Row ingestion timestamp. Returned on both mint-scoped and
            signer-scoped queries.
        marketCap:
          type: number
          description: >
            Market cap in SOL at the time of the trade (present only on
            mint-scoped `/trades/mint/{mint}` queries).
        quoteMint:
          type: string
          description: >
            Mint-scoped only. Native pool-quote mint (USDC, wSOL, USDT, USD1,
            PYUSD). Empty for unrecognised quotes.
        quoteSymbol:
          type: string
          enum:
            - SOL
            - USDC
            - USDT
            - USD1
            - PYUSD
          description: Mint-scoped only.
        quoteAmount:
          type: number
          description: >
            Mint-scoped only. Raw quote-side UI amount the user paid (BUY) or
            received (SELL), in `quoteMint`'s native decimals — NOT
            SOL-normalised.
        quoteDecimals:
          type: integer
          description: Mint-scoped only.
        usdAmount:
          type: number
          description: >-
            Mint-scoped only. Notional USD value (`quoteAmount` × quote USD
            price).
        priceUsd:
          type: number
          description: Mint-scoped only. Per-token USD price.
        venue:
          type: string
          description: >
            Mint-scoped only. DEX program label — PumpSwap / PumpFun / Raydium /
            RaydiumCPMM / RaydiumLaunchpad / MeteoraDammV2 / Jupiter.
        source:
          type: string
          enum:
            - yellowstone
            - shred
            - car
          description: >
            Mint-scoped only. Ingestion path. `yellowstone` = live gRPC, `shred`
            = jito-shred local-sim gap-fill, `car` = Old-Faithful historical
            backfill.
        baseReserves:
          type: number
          description: Mint-scoped only. Token-side reserves AFTER the swap.
        quoteReserves:
          type: number
          description: Mint-scoped only. Quote-side reserves AFTER the swap.
        liquidityUsd:
          type: number
          description: >-
            Mint-scoped only. Pool liquidity in USD (= 2 × quoteReserves ×
            quoteUsdPrice).
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apiKey

````