StarSwap API
Build server-side wallets, trade routes, and settlement flows with the StarSwap API.
Start with Quick start or download the OpenAPI schema.
For agents, use llms.txt. Every guide also has a Markdown URL, starting with this overview.
Start here
| Goal | Guide |
|---|---|
| Set up a server credential and create a wallet | Quick start |
| Authenticate a backend service | Authentication |
| Resolve a network, token, or amount denomination | Chains and tokens |
| Manage balances and wallet settings | Wallets |
| Execute an onchain trade in one request | Market trades |
| Read candles, recent trades, and new pairs | Market data |
| Schedule trades or watch a launch | Automations and sniping |
| Follow activity from other wallets | Wallet tracking |
| Read referrals, points, rewards, and giveaways | Account features |
| Issue a settlement claim | Settlement tickets |
| View the current settlement-vault allocation | 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 for the endpoint and reliability for retries, rate limits, and idempotency.