# StarSwap API

Build server-side wallets, trade routes, and settlement flows with the StarSwap API.

[Start with Quick start](/docs/quick-start) or [download the OpenAPI schema](/openapi.json).

For agents, use [llms.txt](/llms.txt). Every guide also has a Markdown URL, starting with [this overview](/docs/index.md).

## Start here

| Goal | Guide |
| --- | --- |
| Set up a server credential and create a wallet | [Quick start](/docs/quick-start) |
| Authenticate a backend service | [Authentication](/docs/authentication) |
| Resolve a network, token, or amount denomination | [Chains and tokens](/docs/chains-and-tokens) |
| Manage balances and wallet settings | [Wallets](/docs/wallets) |
| Execute an onchain trade in one request | [Market trades](/docs/trades) |
| Read candles, recent trades, and new pairs | [Market data](/docs/market-data) |
| Schedule trades or watch a launch | [Automations and sniping](/docs/automations) |
| Follow activity from other wallets | [Wallet tracking](/docs/wallet-tracking) |
| Read referrals, points, rewards, and giveaways | [Account features](/docs/account-features) |
| Issue a settlement claim | [Settlement tickets](/docs/tickets) |
| View the current settlement-vault allocation | [Reserves](/reserves) |

## Request conventions

Authenticated developer requests use a bearer master API key. Financial and wallet mutations require an `Idempotency-Key`. Some account operations require a browser session instead. Each guide identifies those restrictions.

Send integer amounts as strings. `amountMicros` always uses six decimal places. `amountRaw` uses the token's native decimals, which can differ between chains. Use the returned chain and token descriptors instead of assuming that every settlement asset has six decimals.

The API is versioned under `/v1`. Both `/app` and `/v2` are frontend routes that consume that API. See [base URL](/docs/base-url) for the endpoint and [reliability](/docs/reliability) for retries, rate limits, and idempotency.