> ## Documentation Index > Fetch the complete documentation index at: https://docs.sodax.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > SODAX is mainnet-only (no testnet chains or RPC endpoints exist) with a hub-and-spoke architecture; Sonic is the hub. SODAX is non-custodial protocol/software: it routes and settles; independent solvers on the marketplace fill — never say 'our solver', 'the SODAX solver', that SODAX trades, takes custody, or fills orders. For frontend/React integrations, prefer @sodax/dapp-kit hooks over calling @sodax/sdk directly. SDK operations — the methods that build, submit or await a transaction, and the API/quote calls — return Result ({ ok: true, value } or { ok: false, error }): check result.ok, never wrap them in try/catch or branch on error.message; discriminate on the narrow error.code union instead. Synchronous config getters (getPartnerFee, getSupportedSwapTokens, getVault, ...) return their value directly, not a Result. # HTTP API > Public SODAX HTTP surfaces for partners — base URLs, route prefixes, conventions, and which API to use. Use this section when integrating over raw HTTP (any language). Prefer a [solution hub](/introduction) when you already know the outcome (Swap, Yield, …). For TypeScript end-to-end flows (create intent → relay → settle), use the [SDK functional modules](/developers/packages/foundation/sdk/functional-modules). Quote, build intents, submit-tx, status. Product overview: [Swap hub](/swap). Vault deposit / withdraw. Product overview: [Yield hub](/yield). USD OHLC candles for charts, plus live solver mark prices. Networks, partners, assets, filled-intent volume, and SODA supply. **Exploring these routes with an AI agent?** The [Builders MCP](/builders-mcp) (`https://builders.sodax.com/mcp`) wraps the read surfaces below as tools, so the agent works from today's chains, tokens, quotes and rates instead of its training data. ## Base URLs | Environment | Host | Use | | -------------- | ------------------------------ | --------------------- | | **Production** | `https://api.sodax.com` | Default for partners | | **Canary** | `https://canary-api.sodax.com` | Early features / soak | Always use these public hosts. Do not hard-code private infrastructure hostnames. ## Route map | Prefix | Purpose | Auth | | ---------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | `/v1/swaps/*` | Swaps API v2 — quote, build intent, submit-tx, status | No key enforced yet (rate-limited writes) — see [API keys](/developers/how-to/api-keys) | | `/v1/leverage-yield/*` | Leveraged yield vaults over HTTP | No key enforced yet (same pattern as swaps) — see [API keys](/developers/how-to/api-keys) | | `/v1/be/oracle/*` | USD OHLC price candles for charts | Unauthenticated `GET` | | `/v1/be/solver/*` | Solver volume / orderbook / intent journal reads | Unauthenticated `GET` | | `/v1/be/config/*` | Chains, tokens, hub assets | Unauthenticated `GET` | | `/v1/be/partners/*` | Partner receivers + fee/volume summary | Unauthenticated `GET` | | `/v1/be/sodax/*` | SODA total / circulating supply | Unauthenticated `GET` | | `/v1/be/intent/*` | Intent lookup by hash / tx / user | Unauthenticated `GET` | | `/v1/be/moneymarket/*` | Money-market positions & reserves (read) | Unauthenticated `GET` | | `/v1/intent/*` | Solver service (quote / execute / status / oracle prices) | Unauthenticated | | `/v1/a/*` | Sonic data backend (pools, volume, prices) | Unauthenticated `GET` | | `/v1/sponsorships/*` | Stellar sponsoring | API key (enforced; its own key registry, not a portal key — see [API keys](/developers/how-to/api-keys)) | ## Shared conventions ### BigInt as decimal strings Any amount, chain id field, or token quantity larger than a safe JSON integer is serialized as a **decimal string** on the wire (e.g. `"1000000"`, never a bare JS number for wei-scale values). ```json theme={null} { "inputAmount": "1000000", "deadline": "1786500000" } ``` ### Errors at the edge Unknown routes return: ```json theme={null} { "ok": false, "error": "route_not_found" } ``` Service-level validation errors are typically HTTP `400` with a descriptive message body. Rate-limited writes return `429`. ### Caching Read endpoints are often cached server-side (seconds to a minute). Polling faster than the cache TTL does not yield fresher data. Exact TTLs are noted per page where known. ### Partner fees Partner monetization uses a per-request `partnerFee` object on quote/create-intent style endpoints — there is **no** global default fee. See [Swaps](/developers/http-api/swaps#partner-fee) and the [Monetize SDK](/developers/how-to/monetize_sdk) guide for claiming. ## Choose a path | You want to… | Use | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | Chart USD prices for SODAX assets | [Oracle candles](/developers/http-api/oracle) | | Show live hub token prices | [Solver oracle](/developers/http-api/oracle#solver-oracle-live-prices) | | Show “networks / partners / volume / supply” on a site | [Stats](/developers/http-api/stats) | | Run swaps from a bot or non-TS stack | [Swaps API](/developers/http-api/swaps) | | Deposit into leverage vaults over HTTP | [Leverage yield](/developers/http-api/leverage) | | Activate a new Stellar account | [Stellar sponsoring](/developers/how-to/stellar-sponsoring-getting-started) (`/v1/sponsorships/*`, API key) | | Full wallet + multi-chain UX in React | [`@sodax/sdk`](/developers/packages/foundation/sdk) + [`@sodax/dapp-kit`](/developers/packages/experience/dapp-kit) | ## OpenAPI Machine-readable OpenAPI for the backend API is available at: * `https://api.sodax.com/v1/be/docs` (interactive) * `https://api.sodax.com/v1/be/docs-json` Swaps / leverage share the swaps-api app OpenAPI when that service is enabled (`/docs` on the service origin; edge pathing is under `/v1/swaps` and `/v1/leverage-yield`).