> ## 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.

# Public API

> Read o1 Launchpad data and prepare safe wallet transactions on Base, Robinhood, Monad and Arc.

The o1 Launchpad Public API exposes the useful actions available in the live application without exposing internal analytics, governance, or infrastructure controls.

It supports:

* Base mainnet (`8453`), Robinhood Chain (`4663`), Monad (`143`) and Arc mainnet (`5042`)
* token browsing, search, creator launches, details, trades, announcements, holders, wallets, and fee claims
* crypto-paired token creation on Base, Robinhood, Monad and Arc when enabled, plus stock-paired creation wherever the platform catalog and live factory state make it available, with editable metadata, Pinata uploads, and the required `01` token-address suffix
* exact-input launch-pool quotes and unsigned transaction preparation through the configured router, including SwapX on Arc
* fee claims, creator announcements, and authorized metadata updates

<Warning>
  The API never signs or broadcasts an on-chain transaction. It returns explicit transaction steps for the requested wallet to review, sign, and submit.
</Warning>

X Layer contract integration is documented [separately](/launchpad/integration/direct#x-layer-amounts-and-routing). API clients must use the chains returned by `/v1/config`; chain `196` is not in the current Public API list.

## Base URL

```text theme={null}
https://api.launch.o1.exchange/v1
```

Only `GET /health` is unauthenticated. Send `x-api-key` on every other request.

## Resource model

The API keeps related data together without mixing incompatible query modes:

* `/config` combines production chains, contract configurations, paired assets, and capabilities. Its exact response field names remain `suites` and `quotes` for API compatibility.
* `/tokens` browses and ranks launches, `/tokens/search` searches them, and `/creators/{address}/tokens` lists one creator's launches.
* one token detail endpoint can include pool, market, and recent announcements.
* trades and announcements have independent collection routes and cursors.
* fee claims expose their own state and filters.
* on-chain name, symbol, and key-value updates are separate from token metadata-document updates that pin IPFS content.

This keeps the API compact while ensuring every parameter displayed for an endpoint is valid for that resource.

## Non-custodial transaction flow

```mermaid theme={null}
flowchart LR
  A["Your app"] -->|"prepare or quote"| B["o1 Public API"]
  B -->|"validate live state"| C["Convex and chain RPC"]
  B -->|"transaction steps"| A
  A -->|"user signs"| D["Wallet"]
  D -->|"broadcast"| E["Selected chain"]
  E -->|"verified chain events"| C
```

Every prepare response identifies the expected chain, sender, destination, calldata, value, expiry, issues, and ordered prerequisites. Never replace an API-provided spender or destination with a guessed address.

The existing launchpad indexer discovers confirmed chain events normally. Public clients cannot ask the API to write product records or force an indexing job.

## Next

<CardGroup cols={2}>
  <Card title="Get an API key" icon="key" href="https://launch.o1.exchange/developers">
    Create and manage a scoped production key with your wallet.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/launchpad/api/quickstart">
    List launches and prepare your first trade.
  </Card>

  <Card title="Authentication" icon="key" href="/launchpad/api/authentication">
    Create keys, select scopes, and configure browser origins.
  </Card>

  <Card title="Read endpoints" icon="database" href="/launchpad/api/read-endpoints">
    Search and paginate launchpad resources.
  </Card>

  <Card title="Errors and rate limits" icon="gauge" href="/launchpad/api/errors-and-limits">
    Handle API errors, quotas, and safe retries.
  </Card>

  <Card title="OpenAPI schema" icon="brackets-curly" href="/launchpad-api-openapi.yaml">
    Download the complete machine-readable schema.
  </Card>
</CardGroup>