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

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`) and Robinhood Chain (`4663`)
* token browsing, search, creator launches, details, trades, announcements, holders, wallets, fee claims, and vesting
* standard token creation on Base and Robinhood, plus stock-paired creation wherever the shared platform catalog and live factory state make a route available, with allocations, staircase vesting, editable metadata, Pinata uploads, and the required `01` token-address suffix
* exact-input launch-pool quotes and Universal Router transaction preparation
* fee and vesting 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>

## 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, suites, quotes, and capabilities.
* `/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, allocation, vesting, and recent announcement data.
* trades and announcements have independent collection routes and cursors.
* fee claims and vesting positions expose only their own states 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["Base or Robinhood"]
  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>
