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

# Get custom quote claimable position for a token

> List claimable custom quote fee positions/holdings for a wallet, scoped to a single base mint.

See [Claim Custom Quote Fees](/how-to-guides/claim-custom-quote-fees) for discovery, source selection, and claiming.


## OpenAPI

````yaml GET /token-launch/claimable-position/solo/v2
openapi: 3.1.0
info:
  title: Bags Public API v2
  description: API endpoints for Bags platform
  version: 2.0.0
  contact:
    name: Bags Support
    url: https://support.bags.fm
servers:
  - url: https://public-api-v2.bags.fm/api/v1
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Token Launch
    description: Endpoints for creating and managing token launches
  - name: Fee Share
    description: Endpoints for managing fee sharing configs
  - name: Fee Share Admin
    description: >-
      Endpoints for fee share admin operations including listing, transferring
      admin authority, and updating configs
  - name: Analytics
    description: Endpoints for retrieving token analytics and metadata
  - name: Fee Claiming
    description: Endpoints for claiming fees from various sources
  - name: State
    description: Endpoints for retrieving on-chain state and derived state
  - name: Trade
    description: Endpoints for getting trade quotes and executing token swaps
  - name: Partner
    description: Endpoints for managing partner configurations and claiming partner fees
  - name: Solana
    description: Endpoints for direct Solana blockchain interactions
  - name: EVM
    description: Endpoints for reading Bags EVM token data
  - name: Robinhood Chain
    description: Read endpoints for Bags V2 tokens on Robinhood Chain (chain id 4663)
  - name: Dexscreener
    description: >-
      Endpoints for managing Dexscreener token info orders, payments, and image
      uploads
  - name: Auth
    description: Endpoints for retrieving authenticated user information
  - name: Agent
    description: Endpoints for AI agent wallet-signature authentication (V2)
paths:
  /token-launch/claimable-position/solo/v2:
    get:
      tags:
        - Fee Claiming
      summary: Get custom quote claimable position for a token
      description: >-
        List claimable custom quote fee positions/holdings for a wallet, scoped
        to a single base mint.
      parameters:
        - name: wallet
          in: query
          required: true
          schema:
            type: string
          description: Public key of the wallet to check for claimable positions
        - name: tokenMint
          in: query
          required: true
          schema:
            type: string
          description: Base mint to scope the lookup to
      responses:
        '200':
          description: >-
            Successfully retrieved claimable positions. Returns 200 even when
            individual sources could not be resolved; check response.issues.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - type: object
                    properties:
                      response:
                        $ref: '#/components/schemas/QuoteClaimablesResponse'
        '400':
          description: Bad request - invalid wallet or token mint
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        response:
          description: ''
      required:
        - success
    QuoteClaimablesResponse:
      type: object
      properties:
        contractVersion:
          type: number
          enum:
            - 1
        wallet:
          type: string
          description: Wallet the claimable positions were resolved for
        items:
          type: array
          items:
            $ref: '#/components/schemas/QuoteClaimable'
        complete:
          type: boolean
          description: True when every source resolved without issue (issues is empty)
        issues:
          type: array
          description: >-
            Sources that could not be resolved. The response is still 200 even
            when this is non-empty.
          items:
            type: object
            properties:
              sourceId:
                type:
                  - string
                  - 'null'
                description: Identifier of the source that failed to resolve, or null
              reason:
                $ref: '#/components/schemas/QuoteFailureCode'
            required:
              - sourceId
              - reason
      required:
        - contractVersion
        - wallet
        - items
        - complete
        - issues
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          description: Error message
      required:
        - success
        - error
    QuoteClaimable:
      type: object
      properties:
        id:
          type: string
          description: Identifier for this claimable entry, unique within the response
        wallet:
          type: string
          description: Wallet the claimable entitlement/balance was resolved for
        asset:
          $ref: '#/components/schemas/QuoteAsset'
        source:
          $ref: '#/components/schemas/QuoteClaimableSource'
        rawAmount:
          type:
            - string
            - 'null'
          description: >-
            Claimable amount in raw base units, as a string-encoded amount, or
            null if it could not be observed
        display:
          type: 'null'
          description: Reserved for future use. Always null in the current API version.
        estimatedNetReceiptRaw:
          type: 'null'
          description: Reserved for future use. Always null in the current API version.
        availability:
          $ref: '#/components/schemas/QuoteAvailability'
        observedSlot:
          type:
            - string
            - 'null'
          description: >-
            Slot this entry was observed at, as a string-encoded amount, or null
            if unavailable
        valuation:
          type: object
          properties:
            basis:
              type: string
              enum:
                - current
              description: Valuation basis. Always 'current' in the current API version.
            knownUsd:
              type: string
              description: >-
                Known USD value, as a string-encoded amount. Always '0' in the
                current API version.
            status:
              type: string
              enum:
                - complete
                - unavailable
              description: Whether a full valuation could be computed
            exclusions:
              type: array
              description: Amounts that could not be included in the valuation
              items:
                type: object
                properties:
                  asset:
                    $ref: '#/components/schemas/QuoteAsset'
                  rawAmount:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Excluded amount in raw base units, as a string-encoded
                      amount, or null
                  reason:
                    type: string
                    enum:
                      - balance_unavailable
                      - missing_price
                    description: Why this amount was excluded from the valuation
                  eventCount:
                    type: 'null'
                    description: >-
                      Reserved for future use. Always null in the current API
                      version.
                required:
                  - asset
                  - rawAmount
                  - reason
                  - eventCount
            staleEstimates:
              type: array
              items: {}
              description: >-
                Reserved for future use. Always empty in the current API
                version.
          required:
            - basis
            - knownUsd
            - status
            - exclusions
            - staleEstimates
      required:
        - id
        - wallet
        - asset
        - source
        - rawAmount
        - display
        - estimatedNetReceiptRaw
        - availability
        - observedSlot
        - valuation
    QuoteFailureCode:
      type: string
      description: Machine-readable failure reason for a quote operation.
      enum:
        - account_mismatch
        - airdrop_not_ready
        - asset_frozen
        - asset_paused
        - config_locked
        - fee_limit_exceeded
        - graduation_not_ready
        - insufficient_quote
        - insufficient_sol
        - invalid_request
        - metadata_unavailable
        - nothing_to_claim
        - pair_shortfall
        - pending_reconciliation
        - quote_mismatch
        - quote_not_reviewed
        - rpc_unavailable
        - transaction_too_large
        - transfer_restricted
        - unsupported_bot_assignment
        - unsupported_client
        - unsupported_flow
        - unsupported_format
        - unsupported_profile
    QuoteAsset:
      type: object
      properties:
        mint:
          type: string
          description: Public key of the asset mint
        tokenProgram:
          type: string
          description: >-
            Public key of the SPL token program that owns this mint (Token or
            Token-2022)
        decimals:
          type:
            - number
            - 'null'
          description: >-
            Decimals configured on the mint, or null when it could not be
            observed
      required:
        - mint
        - tokenProgram
        - decimals
    QuoteClaimableSource:
      description: Where this claimable balance/entitlement comes from.
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - pair_entitlement
            baseMint:
              type: string
            config:
              type: string
            authority:
              type: string
            claimerIndex:
              type: number
          required:
            - kind
            - baseMint
            - config
            - authority
            - claimerIndex
        - type: object
          properties:
            kind:
              type: string
              enum:
                - pool_estimate
            baseMint:
              type: string
            pool:
              type: string
            protocol:
              type: string
              enum:
                - dbc
                - damm_v2
          required:
            - kind
            - baseMint
            - pool
            - protocol
        - type: object
          properties:
            kind:
              type: string
              enum:
                - holding_balance
            baseMint:
              type: string
            authority:
              type: string
            tokenAccount:
              type: string
          required:
            - kind
            - baseMint
            - authority
            - tokenAccount
        - type: object
          properties:
            kind:
              type: string
              enum:
                - role_balance
            role:
              type: string
              enum:
                - partner
                - deployer
            owner:
              type: string
            authority:
              type: string
            tokenAccount:
              type: string
          required:
            - kind
            - role
            - owner
            - authority
            - tokenAccount
    QuoteAvailability:
      type: object
      properties:
        status:
          type: string
          enum:
            - available
            - restricted
            - unavailable
          description: Whether the asset/flow can currently be used
        reason:
          allOf:
            - $ref: '#/components/schemas/QuoteFailureCode'
          description: Present when status is restricted or unavailable
          nullable: true
      required:
        - status
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key authentication. Provide your API key as the header value.

````