> ## 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 supported custom quote tokens

> List built-in WSOL and admin-configured non-WSOL DBC quote entries. Each asset appears once, with its DBC configuration types and raw quote graduation thresholds in `flows[].configs`. Check live `profileEligible` and `launchAvailability` before issuing a config; catalog inclusion alone is not an execution guarantee. Thresholds apply to new issuance; already-issued configs retain their parameters. The catalog currently contains DBC entries only; `flow=damm_v2_direct` returns an empty tokens array.

The catalog includes built-in WSOL configurations and non-WSOL DBC configurations saved by Bags administrators. Each asset appears once, with its available configuration types grouped in `flows[].configs`.

For a DBC launch:

1. Request `flow=dbc` and check `profileEligible` and `launchAvailability`.
2. Select a `configs` entry and read its `graduationThresholdRaw` as raw quote units.
3. Pass its `configType` as `bagsConfigType` to [Create Custom Quote Fee Share Config Plan](/api-reference/create-fee-share-config-v2), along with the same quote mint and token program.

`reviewedForLaunch` remains a compatibility field for built-in or admin-configured entries. It does not replace the current availability check. The catalog currently contains DBC entries; `flow=damm_v2_direct` returns an empty `tokens` array.

Thresholds describe new config issuance. Later changes to this listing do not alter a config that has already been issued.

See [Launch a Token with a Custom Quote](/how-to-guides/launch-token-non-sol-quote) for an example and the complete bonding-curve workflow.


## OpenAPI

````yaml GET /token-launch/supported-quote-tokens
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/supported-quote-tokens:
    get:
      tags:
        - Token Launch
      summary: Get supported custom quote tokens
      description: >-
        List built-in WSOL and admin-configured non-WSOL DBC quote entries. Each
        asset appears once, with its DBC configuration types and raw quote
        graduation thresholds in `flows[].configs`. Check live `profileEligible`
        and `launchAvailability` before issuing a config; catalog inclusion
        alone is not an execution guarantee. Thresholds apply to new issuance;
        already-issued configs retain their parameters. The catalog currently
        contains DBC entries only; `flow=damm_v2_direct` returns an empty tokens
        array.
      parameters:
        - name: flow
          in: query
          required: false
          schema:
            type: string
            enum:
              - dbc
              - damm_v2_direct
          description: >-
            Optional flow filter. Omission or dbc returns the DBC catalog;
            damm_v2_direct currently returns an empty tokens array.
      responses:
        '200':
          description: Successfully retrieved supported quote tokens
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - type: object
                    properties:
                      response:
                        $ref: '#/components/schemas/QuoteCapabilitiesResponse'
        '400':
          description: Bad request - invalid flow value
          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
    QuoteCapabilitiesResponse:
      type: object
      properties:
        contractVersion:
          type: number
          enum:
            - 1
        tokens:
          type: array
          items:
            $ref: '#/components/schemas/QuoteCapability'
      required:
        - contractVersion
        - tokens
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          description: Error message
      required:
        - success
        - error
    QuoteCapability:
      type: object
      properties:
        asset:
          $ref: '#/components/schemas/QuoteAsset'
        observedAt:
          type:
            - number
            - 'null'
          description: >-
            Unix timestamp (seconds) the asset's on-chain state was last
            observed, or null if unavailable
        observedSlot:
          type: string
          description: >-
            Slot the asset's on-chain state was observed at, as a string-encoded
            amount
        flows:
          type: array
          description: >-
            Per-flow eligibility and configured launch types. The current
            catalog returns DBC entries, grouped once per asset and flow.
          items:
            type: object
            properties:
              flow:
                type: string
                enum:
                  - dbc
                  - damm_v2_direct
                description: The custom quote launch flow
              profileEligible:
                type: boolean
                description: >-
                  Whether the mint's on-chain profile (extensions, freeze state,
                  etc.) is eligible for this flow
              reviewedForLaunch:
                type: boolean
                description: >-
                  Compatibility field: true for built-in WSOL or
                  admin-configured DBC entries. Does not guarantee current
                  executability; check profileEligible, launchAvailability, and
                  configs.
              launchAvailability:
                $ref: '#/components/schemas/QuoteAvailability'
              configs:
                type: array
                description: >-
                  DBC configurations for this quote, including their raw
                  graduation thresholds. Select a configType as bagsConfigType;
                  omission selects Default and does not fall back to another
                  entry. Added optionally for response compatibility; populated
                  for current DBC catalog entries.
                items:
                  $ref: '#/components/schemas/QuoteDbcConfiguration'
            required:
              - flow
              - profileEligible
              - reviewedForLaunch
              - launchAvailability
      required:
        - asset
        - observedAt
        - observedSlot
        - flows
    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
    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
    QuoteDbcConfiguration:
      type: object
      description: >-
        A built-in WSOL or admin-configured non-WSOL DBC configuration available
        for new issuance.
      properties:
        configType:
          $ref: '#/components/schemas/MeteoraConfigType'
          description: >-
            Pass this value as bagsConfigType when creating a Fee Share config
            for this quote. Only types listed for the selected quote are
            available.
        graduationThresholdRaw:
          type: string
          pattern: ^[1-9][0-9]*$
          description: >-
            Positive graduation threshold in raw quote units, as a decimal
            string to support bigint (maximum u64). Not a USD value or an
            issuer-scaled display quantity. Describes new issuance; existing
            configs retain their issued parameters.
          example: '85000000'
      required:
        - configType
        - graduationThresholdRaw
    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
    MeteoraConfigType:
      type: string
      enum:
        - fa29606e-5e48-4c37-827f-4b03d58ee23d
        - d16d3585-6488-4a6c-9a6f-e6c39ca0fda3
        - a7c8e1f2-3d4b-5a6c-9e0f-1b2c3d4e5f6a
        - 48e26d2f-0a9d-4625-a3cc-c3987d874b9e
        - 810faadb-030b-47de-a68b-7211c1cbbee3
        - e2963a6c-441a-4862-9d80-b94e3a481cd7
        - ba28db46-ea6f-4452-8218-5587f6aca0a1
      default: fa29606e-5e48-4c37-827f-4b03d58ee23d
      description: >-
        Bags config type that determines the token's fee structure. The
        thresholds and compounding percentages below describe SOL-quoted
        launches.


        - `fa29606e-5e48-4c37-827f-4b03d58ee23d` (Default): 2% fees both pre and
        post migration, with 25% fee compounding post-migration. Graduates at
        ~85 SOL.

        - `d16d3585-6488-4a6c-9a6f-e6c39ca0fda3`: 0.25% fees pre-migration, 1%
        post-migration, with 50% fee compounding post-migration. Graduates at
        ~85 SOL.

        - `a7c8e1f2-3d4b-5a6c-9e0f-1b2c3d4e5f6a`: 1% fees pre-migration, 0.25%
        post-migration, with 50% fee compounding post-migration. Graduates at
        ~85 SOL.

        - `48e26d2f-0a9d-4625-a3cc-c3987d874b9e`: 10% fees both pre and post
        migration, with 50% fee compounding post-migration. Graduates at ~85
        SOL.

        - `810faadb-030b-47de-a68b-7211c1cbbee3` (2% Flat, 85% Locked): 2% fees
        both pre and post migration, with 25% fee compounding post-migration.
        85% of token supply is locked. Graduates at ~100 SOL.

        - `e2963a6c-441a-4862-9d80-b94e3a481cd7` (Default, 1K Supply): Same as
        Default (2% fees pre and post migration, 25% fee compounding
        post-migration) but with a 1,000 token supply. Graduates at ~85 SOL.

        - `ba28db46-ea6f-4452-8218-5587f6aca0a1` (2% Base, 96% Locked): 2% base
        fee pre-migration, with 25% fee compounding post-migration. 96% of token
        supply is locked. Post-migration the fee is market-cap based, starting
        at 2% and decaying to a 0.5% floor as the token's market cap grows (~25x
        graduation market cap). Graduates at ~80 SOL.


        For non-WSOL DBC launches, select a type returned in the quote's
        `flows[].configs` from `/token-launch/supported-quote-tokens`. Its saved
        `graduationThresholdRaw` replaces the SOL threshold, and fees are
        collected only in the quote token with zero compounding before and after
        graduation. The 85%-locked type is unavailable for non-WSOL. Omitting
        the type selects Default; the exact quote/type pair must be configured.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key authentication. Provide your API key as the header value.

````