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

# List coins



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/tokens
openapi: 3.1.0
info:
  title: Veto API
  version: 1.0.0
  description: >-
    Public API behind veto.fun. Coins, payouts, wallets, launches, trades and
    vetoes.
servers:
  - url: https://api.veto.fun
    description: Production
  - url: http://localhost:4000
    description: Local development
security: []
tags:
  - name: Platform
  - name: Coins
  - name: Payouts
  - name: Veto
  - name: Launch and trade
paths:
  /api/tokens:
    get:
      tags:
        - Coins
      summary: List coins
      operationId: listTokens
      parameters:
        - name: sort
          in: query
          description: >-
            `mcap` by market cap, `new` newest first, `paid` most paid out,
            `jackpot` biggest jackpot pot.
          schema:
            type: string
            enum:
              - mcap
              - new
              - paid
              - jackpot
            default: mcap
        - name: feature
          in: query
          description: >-
            Only coins that use this job. `veto` means coins with veto turned
            on.
          schema:
            type: string
            enum:
              - jackpot
              - buyback
              - rewards
              - veto
        - name: pair
          in: query
          description: Only coins paired with this kind of asset.
          schema:
            $ref: '#/components/schemas/QuoteCategory'
        - name: q
          in: query
          description: Matches name or ticker (case-insensitive), or an exact mint address.
          schema:
            type: string
            maxLength: 64
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 24
        - name: offset
          in: query
          schema:
            type: integer
            minimum: 0
            default: 0
      responses:
        '200':
          description: A page of coins.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - total
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/TokenSummary'
                  total:
                    type: integer
                    description: Total coins matching the filters.
        '400':
          $ref: '#/components/responses/BadRequest'
components:
  schemas:
    QuoteCategory:
      type: string
      enum:
        - sol
        - stable
        - stock
        - token
    TokenSummary:
      type: object
      required:
        - mint
        - name
        - symbol
        - imageUrl
        - createdAt
        - creatorWallet
        - quote
        - split
        - veto
        - market
        - totals
        - pots
        - drawAt
        - drawAtSol
        - sparkline
      properties:
        mint:
          type: string
        name:
          type: string
        symbol:
          type: string
        imageUrl:
          type:
            - string
            - 'null'
        createdAt:
          type: string
          format: date-time
        creatorWallet:
          type: string
          description: The wallet that launched the coin.
        quote:
          $ref: '#/components/schemas/QuoteInfo'
        split:
          $ref: '#/components/schemas/Split'
        veto:
          type: boolean
          description: Whether holders can veto the creator cut.
        market:
          $ref: '#/components/schemas/TokenMarket'
        totals:
          $ref: '#/components/schemas/TokenTotals'
        pots:
          $ref: '#/components/schemas/TokenPots'
        drawAt:
          type: number
          description: The jackpot draw size in the pair asset.
        drawAtSol:
          type: number
          description: The jackpot draw size in SOL at current prices.
        sparkline:
          type: array
          description: Recent market cap in USD, oldest first.
          items:
            type: number
    QuoteInfo:
      type: object
      description: >-
        The asset a coin is paired with. Fees, pots and payouts are in this
        asset.
      required:
        - mint
        - symbol
        - name
        - icon
        - decimals
        - category
      properties:
        mint:
          type: string
          example: XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2W
        symbol:
          type: string
          example: SPYx
        name:
          type: string
          example: SP500 xStock
        icon:
          type:
            - string
            - 'null'
        decimals:
          type: integer
          example: 8
        category:
          $ref: '#/components/schemas/QuoteCategory'
    Split:
      type: object
      description: How fees are split, in basis points. The four always add up to 10000.
      required:
        - jackpot
        - buyback
        - rewards
        - creator
      properties:
        jackpot:
          type: integer
          minimum: 0
          maximum: 10000
          example: 7000
        buyback:
          type: integer
          minimum: 0
          maximum: 10000
          example: 2000
        rewards:
          type: integer
          minimum: 0
          maximum: 10000
          example: 0
        creator:
          type: integer
          minimum: 0
          maximum: 10000
          example: 1000
    TokenMarket:
      type: object
      required:
        - priceQuote
        - priceSol
        - mcapSol
        - mcapUsd
        - curveProgress
        - graduated
        - holders
        - change24h
        - volume24hUsd
        - volume24hSol
        - buys24h
        - sells24h
        - updatedAt
      properties:
        priceQuote:
          type: number
          description: Price of one whole token in the pair asset.
        priceSol:
          type: number
          description: Price of one whole token in SOL.
        mcapSol:
          type: number
        mcapUsd:
          type: number
        curveProgress:
          type: number
          minimum: 0
          maximum: 1
          description: Bonding curve progress. 1 once graduated.
        graduated:
          type: boolean
          description: Whether the coin has moved to PumpSwap.
        holders:
          type: integer
          description: Holders at the last snapshot.
        change24h:
          type:
            - number
            - 'null'
          description: Market cap change over 24 hours as a fraction. 0.12 is +12%.
        volume24hUsd:
          type: number
        volume24hSol:
          type: number
        buys24h:
          type: integer
        sells24h:
          type: integer
        updatedAt:
          type:
            - string
            - 'null'
          format: date-time
    TokenTotals:
      type: object
      description: >-
        Lifetime totals. Plain fields are in the pair asset; `*Sol` fields are
        the SOL value at the time of each payout.
      required:
        - claimed
        - paid
        - jackpot
        - buyback
        - rewards
        - creator
        - vetoed
        - claimedSol
        - paidSol
        - jackpotSol
        - jackpotsWon
        - buybackSol
        - burnedTokens
        - rewardsSol
        - creatorSol
        - vetoedSol
      properties:
        claimed:
          type: number
        paid:
          type: number
        jackpot:
          type: number
        buyback:
          type: number
        rewards:
          type: number
        creator:
          type: number
        vetoed:
          type: number
        claimedSol:
          type: number
          description: Creator fees claimed from pump.fun.
        paidSol:
          type: number
          description: Jackpots, buybacks, rewards and creator payouts combined.
        jackpotSol:
          type: number
        jackpotsWon:
          type: integer
        buybackSol:
          type: number
        burnedTokens:
          type: number
          description: Whole tokens burned.
        rewardsSol:
          type: number
        creatorSol:
          type: number
        vetoedSol:
          type: number
          description: Creator escrow sent to burn by holder vetoes.
    TokenPots:
      type: object
      description: >-
        Waiting in each pot for a future cycle. Plain fields are in the pair
        asset; `*Sol` fields are their current SOL value.
      required:
        - jackpot
        - buyback
        - rewards
        - creatorEscrow
        - jackpotSol
        - buybackSol
        - rewardsSol
        - creatorEscrowSol
      properties:
        jackpot:
          type: number
        buyback:
          type: number
        rewards:
          type: number
        creatorEscrow:
          type: number
        jackpotSol:
          type: number
        buybackSol:
          type: number
        rewardsSol:
          type: number
        creatorEscrowSol:
          type: number
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: A message you can show to users as-is.
  responses:
    BadRequest:
      description: The request is invalid. The message names the field.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: 'symbol: Ticker can only use letters and numbers'

````

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