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

# Get API configuration

> Get production suites, contract addresses, quote assets, capabilities, and live creation state for one chain.



## OpenAPI

````yaml /launchpad-api-openapi.yaml get /config
openapi: 3.1.0
info:
  title: o1 Launchpad Public API
  version: 1.0.0
  description: >-
    Non-custodial API for launchpad data and unsigned transaction preparation on
    Base and Robinhood.
servers:
  - url: https://api.launch.o1.exchange/v1
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Meta
    description: Service health and live integration configuration.
  - name: Tokens
    description: Token discovery, detail, activity, and holder data.
  - name: Wallets
    description: Public wallet activity and claim positions.
  - name: Transactions
    description: Indexed launchpad transaction state.
  - name: Launches
    description: Unsigned launch transaction preparation.
  - name: Swaps
    description: Exact-input swap quotes and unsigned router transactions.
  - name: Claims
    description: Unsigned fee and vesting claim transactions.
  - name: Creators
    description: Unsigned creator announcement and metadata transactions.
externalDocs:
  description: Error codes, rate limits, and safe retry guidance
  url: https://docs.o1.exchange/launchpad/api/errors-and-limits
paths:
  /config:
    get:
      tags:
        - Meta
      summary: Get API configuration
      description: >-
        Get production suites, contract addresses, quote assets, capabilities,
        and live creation state for one chain.
      operationId: getConfig
      parameters:
        - name: chain_id
          in: query
          required: true
          description: >-
            Production chain to query: 8453 for Base or 4663 for Robinhood
            Chain.
          example: 8453
          schema:
            $ref: '#/components/schemas/ChainId'
        - name: market
          in: query
          description: >-
            Launch market to include: standard tokens, RWA assets, or all
            markets.
          schema:
            type: string
            enum:
              - standard
              - rwa
              - all
            default: all
        - name: include
          in: query
          description: 'Comma-separated sections to return: chains, suites, and quotes.'
          schema:
            type: string
            default: chains,suites,quotes
        - name: active_only
          in: query
          description: >-
            When true, omit historical suites and quote assets that cannot
            create new launches.
          schema:
            type: boolean
            default: true
      responses:
        '200':
          description: Current launchpad integration configuration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigurationResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
        '502':
          $ref: '#/components/responses/UpstreamError'
        '503':
          $ref: '#/components/responses/Unavailable'
        '504':
          $ref: '#/components/responses/UpstreamTimeout'
components:
  schemas:
    ChainId:
      type: integer
      enum:
        - 8453
        - 4663
      examples:
        - 8453
      description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.'
    ConfigurationResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          $ref: '#/components/schemas/Configuration'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    Configuration:
      type: object
      properties:
        chain:
          $ref: '#/components/schemas/ChainConfiguration'
        supported_chain_ids:
          type: array
          items:
            type: integer
            enum:
              - 8453
              - 4663
            examples:
              - 8453
            description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.'
        suites:
          type: array
          items:
            $ref: '#/components/schemas/ContractSuite'
        quotes:
          type: array
          items:
            $ref: '#/components/schemas/QuoteConfiguration'
        as_of_block:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
    ResponseMeta:
      type: object
      required:
        - request_id
        - generated_at
        - warnings
      properties:
        request_id:
          type: string
          examples:
            - req_01JZZZZZZZZZZZZZZZZZZZZZZZ
        generated_at:
          type: string
          format: date-time
          examples:
            - '2026-07-31T12:00:00.000Z'
        warnings:
          type: array
          items:
            type: string
    Problem:
      type: object
      required:
        - type
        - title
        - status
        - code
        - detail
        - action
        - instance
        - request_id
      properties:
        type:
          type: string
          format: uri
          description: >-
            Canonical section of the public error guide for this stable problem
            code.
          examples:
            - https://docs.o1.exchange/launchpad/api/errors-and-limits#not-found
        title:
          type: string
        status:
          type: integer
          minimum: 400
          maximum: 599
        code:
          type: string
          enum:
            - invalid_request
            - unknown_parameter
            - duplicate_parameter
            - incompatible_parameters
            - invalid_parameter
            - missing_idempotency_key
            - invalid_idempotency_key
            - missing_api_key
            - invalid_api_key
            - origin_not_allowed
            - insufficient_scope
            - wallet_not_authorized
            - not_found
            - stale_plan
            - stale_quote
            - salt_unavailable
            - invalid_permit
            - approval_not_confirmed
            - announcement_id_conflict
            - cursor_filter_mismatch
            - cursor_stale
            - idempotency_in_progress
            - nothing_to_claim
            - unsupported_operation
            - unsupported_chain
            - idempotency_key_reused
            - invalid_amount
            - invalid_referrer
            - invalid_allocation
            - invalid_vesting
            - insufficient_balance
            - quote_unavailable
            - simulation_failed
            - rate_limit_exceeded
            - quota_exceeded
            - internal_error
            - upstream_error
            - temporarily_unavailable
            - upstream_timeout
          description: >-
            Stable machine-readable error code. Branch on this value instead of
            detail.
        detail:
          type: string
        action:
          type: string
          description: Safe next step for the caller.
        instance:
          type: string
        request_id:
          type: string
        invalid_parameters:
          type: array
          items:
            $ref: '#/components/schemas/InvalidParameter'
        suggested_endpoint:
          type: string
        resource:
          type: string
        chain_id:
          type: integer
          enum:
            - 8453
            - 4663
          examples:
            - 8453
          description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.'
        token_address:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        asset:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        actual_raw:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
        required_raw:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
    ChainConfiguration:
      type: object
      required:
        - chain_id
        - name
        - native_currency
        - capabilities
      properties:
        chain_id:
          type: integer
          enum:
            - 8453
            - 4663
          examples:
            - 8453
          description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.'
        name:
          type: string
        native_currency:
          type: object
          required:
            - symbol
            - decimals
          properties:
            symbol:
              type: string
            decimals:
              type: integer
              minimum: 0
              maximum: 255
        capabilities:
          $ref: '#/components/schemas/ChainCapabilities'
    ContractSuite:
      type: object
      required:
        - id
        - version
        - chain_id
        - route
        - active_for_creation
        - creation_available
        - first_block
        - token_mode
        - contracts
        - capabilities
      properties:
        id:
          type: string
        version:
          type: string
        chain_id:
          type: integer
          enum:
            - 8453
            - 4663
          examples:
            - 8453
          description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.'
        route:
          type: string
          enum:
            - standard
            - rwa
          description: 'Launch market: standard tokens or RWA assets.'
        active_for_creation:
          type: boolean
        creation_available:
          type: boolean
        first_block:
          type: integer
          minimum: 0
        token_mode:
          type: string
          enum:
            - b20
            - erc20
        config_version:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
        launch_supply_raw:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
        launch_creation_enabled:
          type: boolean
        creation_fee:
          $ref: '#/components/schemas/ConfigurationCreationFee'
        contracts:
          $ref: '#/components/schemas/SuiteContracts'
        capabilities:
          $ref: '#/components/schemas/SuiteCapabilities'
    QuoteConfiguration:
      type: object
      required:
        - address
        - symbol
        - decimals
        - route
        - suite_id
        - registered
        - selectable
      properties:
        address:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        symbol:
          type: string
        name:
          type: string
        decimals:
          type: integer
          minimum: 0
          maximum: 255
        route:
          type: string
          enum:
            - standard
            - rwa
          description: 'Launch market: standard tokens or RWA assets.'
        suite_id:
          type: string
        registered:
          type: boolean
        selectable:
          type: boolean
        quote_revision:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
        creation_fee:
          $ref: '#/components/schemas/ConfigurationCreationFee'
    InvalidParameter:
      type: object
      required:
        - name
        - reason
        - detail
      properties:
        name:
          type: string
        reason:
          type: string
        detail:
          type: string
        allowed:
          type: array
          items:
            type: string
    ChainCapabilities:
      type: object
      required:
        - launch_token_mode
        - b20_asset_status
      properties:
        launch_token_mode:
          type: string
          enum:
            - b20
            - erc20
        b20_asset_status:
          type: string
          enum:
            - active
            - inactive
            - not_checked
            - not_applicable
          description: >-
            Live B20 feature status. Static chain-only requests return
            not_checked; non-B20 chains return not_applicable.
    ConfigurationCreationFee:
      type: object
      required:
        - amount_raw
        - currency
        - symbol
        - decimals
      properties:
        amount_raw:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          examples:
            - '1000000000000000000'
          description: >-
            Unsigned integer encoded as a base-10 string to preserve full
            precision.
        currency:
          type: string
        symbol:
          type: string
        decimals:
          type: integer
          minimum: 0
          maximum: 255
    SuiteContracts:
      type: object
      required:
        - factory
        - hook
        - fee_escrow
        - vesting_vault
        - announcement_registry
        - pool_manager
        - state_view
        - quoter
        - universal_router
        - permit2
      properties:
        factory:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        hook:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        fee_escrow:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        vesting_vault:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        announcement_registry:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        pool_manager:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        state_view:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        quoter:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        universal_router:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
        permit2:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          examples:
            - '0x1111111111111111111111111111111111111111'
          description: >-
            EVM address. The zero address represents native currency only where
            documented.
    SuiteCapabilities:
      type: object
      required:
        - launch_creation_fee
        - announcements
        - vesting
        - editable_metadata
        - quote_revisions
        - launch_creation_switch
      properties:
        launch_creation_fee:
          type: boolean
        announcements:
          type: boolean
        vesting:
          type: boolean
        editable_metadata:
          type: boolean
        quote_revisions:
          type: boolean
        launch_creation_switch:
          type: boolean
  responses:
    BadRequest:
      description: The request syntax, parameter combination, cursor, or body is invalid.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Unauthorized:
      description: >-
        The API key is missing, malformed, expired, revoked, or otherwise
        invalid.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Forbidden:
      description: >-
        The API key scope, browser origin, or connected wallet is not
        authorized.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Unprocessable:
      description: >-
        The request is valid JSON but is unsupported, invalid on-chain, or not
        executable.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    RateLimited:
      description: >-
        The key, wallet, token, creator, or expensive operation exceeded a rate
        or concurrency limit.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        Retry-After:
          description: Seconds until the limited operation may be retried.
          schema:
            type: integer
            minimum: 1
    InternalError:
      description: >-
        An unexpected server fault occurred. Retry once, then contact support
        with the request_id if it persists.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    UpstreamError:
      description: >-
        A required chain, metadata, indexer, or holder provider returned an
        invalid response.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Unavailable:
      description: >-
        A required service, chain dependency, cursor signer, or holder snapshot
        is unavailable.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    UpstreamTimeout:
      description: A required upstream service timed out.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Production API key beginning with o1_launch_.

````