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

# Get a coin

> Everything on a coin's page, including settings, pots and veto state.



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/tokens/{mint}
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/{mint}:
    get:
      tags:
        - Coins
      summary: Get a coin
      description: Everything on a coin's page, including settings, pots and veto state.
      operationId: getToken
      parameters:
        - $ref: '#/components/parameters/Mint'
      responses:
        '200':
          description: The coin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenDetail'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    Mint:
      name: mint
      in: path
      required: true
      description: The coin's mint address.
      schema:
        type: string
  schemas:
    TokenDetail:
      allOf:
        - $ref: '#/components/schemas/TokenSummary'
        - type: object
          required:
            - description
            - twitter
            - telegram
            - website
            - vault
            - settings
            - lastCycleAt
            - nextCycleAt
            - vetoState
          properties:
            description:
              type: string
            twitter:
              type:
                - string
                - 'null'
            telegram:
              type:
                - string
                - 'null'
            website:
              type:
                - string
                - 'null'
            vault:
              type: string
              description: The coin's fee vault, which is its creator on pump.fun.
            settings:
              $ref: '#/components/schemas/LaunchSettings'
            lastCycleAt:
              type:
                - string
                - 'null'
              format: date-time
            nextCycleAt:
              type: string
              format: date-time
            vetoState:
              oneOf:
                - $ref: '#/components/schemas/VetoState'
                - type: 'null'
    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
    LaunchSettings:
      type: object
      required:
        - split
        - jackpot
        - rewards
        - creator
        - minHoldTokens
        - excludeWallets
      properties:
        split:
          $ref: '#/components/schemas/Split'
        jackpot:
          type: object
          required:
            - odds
            - drawAtSol
          properties:
            odds:
              type: string
              enum:
                - weighted
                - equal
              description: '`weighted` by bag size, or `equal` for every eligible wallet.'
            drawAt:
              type: number
              exclusiveMinimum: 0
              description: The pot is drawn once it reaches this, in the coin's pair asset.
              example: 0.5
        rewards:
          type: object
          required:
            - asset
            - topHolders
          properties:
            asset:
              type: string
              enum:
                - quote
                - token
              description: Pay rewards in the pair asset or in the coin itself.
            topHolders:
              type: integer
              minimum: 0
              maximum: 1000
              description: Pay only the largest N holders. 0 pays everyone eligible.
        creator:
          type: object
          required:
            - wallet
            - veto
            - vetoThresholdPct
          properties:
            wallet:
              type: string
              description: Where the creator cut is paid.
            veto:
              type: boolean
              description: Hold the creator cut in 24-hour escrow that holders can veto.
            vetoThresholdPct:
              type: number
              minimum: 1
              maximum: 50
              description: Share of supply that must sign to veto a payout.
              example: 10
        minHoldTokens:
          type: number
          minimum: 0
          maximum: 50000000
          description: Whole tokens a wallet needs to count as a holder.
          example: 100000
        excludeWallets:
          type: array
          maxItems: 20
          description: >-
            Wallets that never receive jackpots or rewards and don't count
            toward vetoes.
          items:
            type: string
    VetoState:
      type: object
      required:
        - epoch
        - endsAt
        - thresholdPct
        - weightPct
        - voters
        - escrow
        - escrowSol
      properties:
        epoch:
          type: integer
          description: >-
            The current 24-hour window, starting at 0 at launch. Sign this
            number.
        endsAt:
          type: string
          format: date-time
        thresholdPct:
          type: number
          description: Share of supply needed to veto.
        weightPct:
          type: number
          description: Share of supply held by wallets that signed so far.
        voters:
          type: integer
        escrow:
          type: number
          description: Creator cut held for this window, in the pair asset.
        escrowSol:
          type: number
          description: The escrow's SOL value at current prices.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: A message you can show to users as-is.
    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
    QuoteCategory:
      type: string
      enum:
        - sol
        - stable
        - stock
        - token
  responses:
    NotFound:
      description: Not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Token not found

````

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