# StarSwap

> StarSwap provides custodial wallets, a shared settlement balance across supported chains, market trading, and settlement tickets.

Production API base URL: https://starswap.cc/api. API resources use /v1; /v2 is a frontend route, not a second API version.

Use a server-side bearer master key for authenticated developer requests. Browser-only operations and scoped extension credentials have separate access rules. Preserve the original idempotency key and request while recovering an unresolved submission.

Amounts are decimal strings. amountMicros always uses six decimal places; amountRaw uses the selected token's decimals. Read GET /v1/chains before constructing amounts.

## Get started

- [StarSwap API](https://starswap.cc/docs/index.md): Build wallet, market trading, and settlement flows with the StarSwap API.
- [Quick start](https://starswap.cc/docs/quick-start.md): Create a master key, create a wallet, and verify your first authenticated request.
- [Authentication](https://starswap.cc/docs/authentication.md): Create and send a StarSwap master API key.
- [Base URL](https://starswap.cc/docs/base-url.md): Choose the production StarSwap API origin and versioned path.
- [First request](https://starswap.cc/docs/first-request.md): Create a wallet with an authenticated, idempotent API request.
- [Chains and tokens](https://starswap.cc/docs/chains-and-tokens.md): Discover networks, settlement decimals, native assets, and verified token identities.

## Wallets and balances

- [Wallets](https://starswap.cc/docs/wallets.md): Create, inspect, rename, archive, restore, and export account wallets.
- [Balance transfers](https://starswap.cc/docs/transfers.md): Move available stablecoin balance between account wallets.
- [Withdrawals](https://starswap.cc/docs/withdrawals.md): Send settlement balance or direct wallet assets to an address or StarSwap email.

## Trading

- [Market trades](https://starswap.cc/docs/trades.md): Execute a market trade in one request or inspect a quote before submission.
- [Market data](https://starswap.cc/docs/market-data.md): Read token snapshots, candle history, recent trades, holders, and new pairs.
- [Automations and sniping](https://starswap.cc/docs/automations.md): Create and monitor wallet-bound DCA, Pulse strategies, and sniper rules.
- [Wallet tracking](https://starswap.cc/docs/wallet-tracking.md): Manage tracked addresses, import up to 10,000 wallets, and read their live activity.

## Settlement

- [Settlement tickets](https://starswap.cc/docs/tickets.md): Issue and inspect wallet-scoped settlement tickets.

## Resources

- [Account features](https://starswap.cc/docs/account-features.md): Read referrals, points, giveaways, creator rewards, and account value history.
- [Errors and limits](https://starswap.cc/docs/reliability.md): Handle idempotency, rate limits, retries, and API failures.

## API schema

- [OpenAPI](https://starswap.cc/openapi.json): Generated HTTP endpoint, request, and response schemas. Read the authentication guide for credential restrictions.