> ## 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. # Quote a swap > Get a live exact-input launch-pool quote, minimum output, and any ERC-20 approval or Permit2 signature requirements. The quote expires after 2 minutes. ## OpenAPI ````yaml /launchpad-api-openapi.yaml post /swaps/quote 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: /swaps/quote: post: tags: - Swaps summary: Quote a swap description: >- Get a live exact-input launch-pool quote, minimum output, and any ERC-20 approval or Permit2 signature requirements. The quote expires after 2 minutes. operationId: quoteSwap requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SwapQuoteRequest' responses: '200': description: A signed short-lived quote and prerequisite steps. content: application/json: schema: $ref: '#/components/schemas/SwapQuoteResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '413': $ref: '#/components/responses/TooLarge' '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: SwapQuoteRequest: type: object required: - chain_id - wallet - token_address - side - amount_in_raw - slippage_bps properties: chain_id: type: integer enum: - 8453 - 4663 examples: - 8453 description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.' wallet: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: Wallet that will execute the prepared swap. not: const: '0x0000000000000000000000000000000000000000' token_address: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- Tracked launch token to buy or sell, returned as token.address by GET /tokens. not: const: '0x0000000000000000000000000000000000000000' side: type: string enum: - buy - sell description: >- buy spends the quote asset for launch tokens; sell spends launch tokens for the quote asset. amount_in_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: >- Exact input in base units: quote-asset units for buy, launch-token units for sell. Range: 1 through uint128 max. slippage_bps: type: integer minimum: 0 maximum: 4999 examples: - 50 description: >- Slippage tolerance in basis points. 1 bps = 0.01%; 50 means 0.5%, 100 means 1%, and 300 means 3%. The swap reverts below the calculated minimum output. referrer: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- Optional eligible referral wallet. It cannot be the trader, creator, platform treasury, or router. not: const: '0x0000000000000000000000000000000000000000' comment: type: string maxLength: 32 description: Optional hook comment limited to 32 UTF-8 bytes. SwapQuoteResponse: type: object required: - data - meta properties: data: $ref: '#/components/schemas/SwapQuoteResult' meta: $ref: '#/components/schemas/ResponseMeta' SwapQuoteResult: type: object required: - quote_id - prepared_at - expires_at - chain_id - observed_block - input_currency - output_currency - amount_in_raw - expected_out_raw - minimum_out_raw - quote_gas - review - issues - steps properties: quote_id: type: string description: >- Opaque signed quote for /swaps/prepare. Do not modify it and use it before expires_at. prepared_at: type: string format: date-time examples: - '2026-07-31T12:00:00.000Z' expires_at: type: string format: date-time examples: - '2026-07-31T12:00:00.000Z' chain_id: type: integer enum: - 8453 - 4663 examples: - 8453 description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.' observed_block: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Chain block used to produce this quote. input_currency: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. output_currency: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. amount_in_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Exact input amount in input-currency base units. expected_out_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Quoted output in output-currency base units. minimum_out_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Minimum accepted output after applying the requested slippage. quote_gas: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Gas estimate returned by the v4 Quoter. review: $ref: '#/components/schemas/SwapQuoteReview' issues: type: array items: $ref: '#/components/schemas/PlanIssue' steps: type: array items: $ref: '#/components/schemas/TransactionStep' 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. SwapQuoteReview: type: object required: - token_address - side - input_currency - output_currency - amount_in_raw - expected_out_raw - minimum_out_raw - slippage_bps properties: 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. side: type: string enum: - buy - sell input_currency: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. output_currency: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. amount_in_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Exact input amount in input-currency base units. expected_out_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Quoted output in output-currency base units. minimum_out_raw: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Minimum accepted output after applying slippage_bps. slippage_bps: type: integer minimum: 0 maximum: 4999 description: Slippage tolerance used to calculate minimum_out_raw. 100 bps = 1%. referrer: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. comment: type: string PlanIssue: type: object required: - code - severity properties: code: type: string severity: type: string enum: - blocking - action_required - warning detail: type: string asset: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. spender: 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. remediation_step_id: type: string TransactionStep: oneOf: - type: object required: - id - kind - label - depends_on - transaction properties: id: type: string kind: type: string const: transaction label: type: string depends_on: type: array items: type: string description: Step IDs that must be completed before this step. transaction: $ref: '#/components/schemas/TransactionRequest' simulation: $ref: '#/components/schemas/Simulation' - type: object required: - id - kind - label - depends_on - typed_data properties: id: type: string kind: type: string const: typed_data label: type: string depends_on: type: array items: type: string description: Step IDs that must be completed before this step. typed_data: $ref: '#/components/schemas/TypedDataRequest' simulation: $ref: '#/components/schemas/Simulation' InvalidParameter: type: object required: - name - reason - detail properties: name: type: string reason: type: string detail: type: string allowed: type: array items: type: string TransactionRequest: type: object required: - chain_id - from - to - data - value properties: chain_id: type: integer enum: - 8453 - 4663 examples: - 8453 description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.' from: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: Wallet expected to send this transaction. to: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: Verified contract or approval target. data: type: string pattern: ^0x(?:[0-9a-fA-F]{2})*$ description: Complete transaction calldata. Do not modify it. value: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: >- Native-currency value in base units. Use 0 when no native value is required. Simulation: type: object required: - status properties: status: type: string enum: - succeeded - not_run description: >- succeeded means the step simulated; not_run means a prerequisite must be completed first. block_number: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: Block used for simulation when status is succeeded. TypedDataRequest: type: object required: - domain - types - primaryType - message properties: domain: $ref: '#/components/schemas/Permit2TypedDataDomain' types: $ref: '#/components/schemas/Permit2TypedDataTypes' primaryType: type: string const: PermitSingle message: $ref: '#/components/schemas/Permit2Message' Permit2TypedDataDomain: type: object required: - name - chainId - verifyingContract properties: name: type: string const: Permit2 chainId: type: integer enum: - 8453 - 4663 examples: - 8453 description: 'Production chain ID: 8453 for Base or 4663 for Robinhood Chain.' verifyingContract: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. Permit2TypedDataTypes: type: object required: - PermitSingle - PermitDetails properties: PermitSingle: type: array items: $ref: '#/components/schemas/TypedDataField' PermitDetails: type: array items: $ref: '#/components/schemas/TypedDataField' Permit2Message: type: object required: - details - spender - sigDeadline properties: details: $ref: '#/components/schemas/Permit2DetailsMessage' spender: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. sigDeadline: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: >- Unsigned integer encoded as a base-10 string to preserve full precision. TypedDataField: type: object required: - name - type properties: name: type: string type: type: string Permit2DetailsMessage: type: object required: - token - amount - expiration - nonce properties: token: type: string pattern: ^0x[0-9a-fA-F]{40}$ examples: - '0x1111111111111111111111111111111111111111' description: >- EVM address. The zero address represents native currency only where documented. amount: type: string pattern: ^(0|[1-9][0-9]*)$ examples: - '1000000000000000000' description: >- Unsigned integer encoded as a base-10 string to preserve full precision. expiration: type: integer minimum: 1 nonce: type: integer minimum: 0 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' NotFound: description: The requested tracked launchpad resource does not exist. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' TooLarge: description: The request body exceeds the operation's supported size. 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_. ````