> ## 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 wallet's payouts

> What a wallet has been paid, what's on its way, its payout history and the coins it launched.



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/wallet/{address}
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/wallet/{address}:
    get:
      tags:
        - Payouts
      summary: Get a wallet's payouts
      description: >-
        What a wallet has been paid, what's on its way, its payout history and
        the coins it launched.
      operationId: getWallet
      parameters:
        - name: address
          in: path
          required: true
          description: Any Solana wallet address.
          schema:
            type: string
            example: CYsSvaFXefBgjGY2qkPRjFYYvHdNRxdSyswytymTMkfL
      responses:
        '200':
          description: Wallet summary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletSummary'
        '400':
          $ref: '#/components/responses/BadRequest'
components:
  schemas:
    WalletSummary:
      type: object
      required:
        - wallet
        - totalPaidSol
        - totalOwedSol
        - jackpotsWon
        - positions
        - events
        - launched
      properties:
        wallet:
          type: string
        totalPaidSol:
          type: number
          description: Everything paid to this wallet, with token rewards valued in SOL.
        totalOwedSol:
          type: number
        jackpotsWon:
          type: integer
        positions:
          type: array
          items:
            $ref: '#/components/schemas/WalletPosition'
        events:
          type: array
          description: Payouts to this wallet, newest first.
          items:
            $ref: '#/components/schemas/FeedEvent'
        launched:
          type: array
          description: Coins this wallet launched.
          items:
            $ref: '#/components/schemas/TokenSummary'
    WalletPosition:
      type: object
      required:
        - mint
        - symbol
        - name
        - imageUrl
        - quote
        - asset
        - owed
        - paid
      properties:
        mint:
          type: string
        symbol:
          type: string
        name:
          type: string
        imageUrl:
          type:
            - string
            - 'null'
        quote:
          $ref: '#/components/schemas/QuoteInfo'
        asset:
          type: string
          enum:
            - quote
            - token
          description: >-
            `quote`: paid in the coin's pair asset. `token`: paid in the coin
            itself.
        owed:
          type: number
          description: Credited but not yet sent, in `asset`.
        paid:
          type: number
          description: Already sent, in `asset`.
    FeedEvent:
      type: object
      required:
        - id
        - kind
        - mint
        - symbol
        - tokenName
        - imageUrl
        - quote
        - amount
        - amountSol
        - tokenAmount
        - wallet
        - recipients
        - signature
        - meta
        - createdAt
      properties:
        id:
          type: integer
        kind:
          $ref: '#/components/schemas/EventKind'
        mint:
          type: string
        symbol:
          type: string
        tokenName:
          type: string
        imageUrl:
          type:
            - string
            - 'null'
        quote:
          $ref: '#/components/schemas/QuoteInfo'
        amount:
          type: number
          description: >-
            Amount moved by this event, in the coin's pair asset. 0 for
            launches.
        amountSol:
          type: number
          description: The amount's SOL value at the time of the event.
        tokenAmount:
          type:
            - number
            - 'null'
          description: Whole tokens burned or paid, when relevant.
        wallet:
          type:
            - string
            - 'null'
          description: The recipient, for jackpots and single payouts.
        recipients:
          type:
            - integer
            - 'null'
          description: >-
            Wallets paid in a rewards batch, or eligible holders in a jackpot
            draw.
        signature:
          type:
            - string
            - 'null'
          description: The transaction signature.
        meta:
          type: object
          additionalProperties: true
          description: >-
            Extra details. Jackpots include `seed`, `blockhash`, `slot`,
            `snapshotHash`, `odds` and `winnerBalance`. Vetoes include `epoch`,
            `weightPct`, `voters` and `thresholdPct`.
        createdAt:
          type: string
          format: date-time
    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
    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'
    EventKind:
      type: string
      enum:
        - launch
        - claim
        - jackpot
        - buyback
        - rewards
        - creator
        - veto
    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:
    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.