Skip to main content
Use this section when integrating over raw HTTP (any language). Prefer a solution hub when you already know the outcome (Swap, Yield, …). For TypeScript end-to-end flows (create intent → relay → settle), use the SDK functional modules.

Swap API

Quote, build intents, submit-tx, status. Product overview: Swap hub.

Leverage yield API

Vault deposit / withdraw. Product overview: Yield hub.

Oracle

USD OHLC candles for charts, plus live solver mark prices.

Protocol stats

Networks, partners, assets, filled-intent volume, and SODA supply.
Exploring these routes with an AI agent? The 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

Always use these public hosts. Do not hard-code private infrastructure hostnames.

​
Route map

​
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).

​
Errors at the edge

Unknown routes return:
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 and the Monetize SDK guide for claiming.

​
Choose a path

​
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).