> ## 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<T, E> ({ 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.

# API

> Integrate SODAX from any language over the HTTP API.

## Get started

The HTTP API is the main path for new integrations. It works from any language over standard REST. Get your API key at [portal.sodax.com](https://portal.sodax.com), then pick an API:

> [card] [Swaps API](https://docs.sodax.com/developers/http-api/swaps.md)
>
> Quote, build intent, submit-tx, status — the full swap lifecycle over REST.

> [card] [Leverage Yield API](https://docs.sodax.com/developers/http-api/leverage.md)
>
> Deposit into and withdraw from leveraged yield vaults.

> [card] [Oracle API](https://docs.sodax.com/developers/http-api/oracle.md)
>
> USD price candles and live solver prices.

> [card] [Stats API](https://docs.sodax.com/developers/http-api/stats.md)
>
> Networks, partners, assets, filled-intent volume and SODA supply.

Base URLs and shared conventions are on the [HTTP API overview](https://docs.sodax.com/developers/http-api.md).

A swap over REST goes **quote** → **approve** if needed → **build intent** → sign and broadcast it on the source chain → **submit-tx** → poll **status**. The [bot flow](https://docs.sodax.com/developers/http-api/swaps.md#bot-flow-create-submit-tx-poll) walks through each call.

[Get an API key →](https://docs.sodax.com/developers/how-to/api-keys.md)

## Advanced: open-source SDK

The TypeScript SDK is built for teams that want full end-to-end TypeScript control — custom wallet integration, raw module access, or features the HTTP API does not cover, such as lend/borrow and staking. It hits the same SODAX execution layer as the HTTP API.

### 1. Foundation: @sodax/sdk

The core logic layer. Raw functional modules to build with SODAX programmatically.

Functional modules:

* **Swaps** — quote and execute cross-network intents. SODAX routes and settles; solvers on the marketplace fill.
* **Lend / Borrow** — interact directly with the SODAX money market.
* **Leverage Yield** — leveraged yield vaults on the Sonic hub.
* **Bridge** — low-level primitives for asset transfer.
* **Staking** — manage SODA staking and governance positions.
* **Migration** — utilities for migrating ICX to SODA.

Tooling modules:

* **Backend API** — useful data points for each feature.
* **Intent Relay API** — direct access to the intent propagation network.

### 2. Connection layer

Manages connecting user wallets across heterogeneous networks (EVM, SVM, and non-EVM chains). Two flavors:

* **@sodax/wallet-sdk-core** — pure TypeScript wallet providers. Use for a custom frontend framework or a non-React app.
* **@sodax/wallet-sdk-react** — opinionated React wrapper with pre-built context providers and state management.

### 3. Experience layer: @sodax/dapp-kit

The highest-level layer. React hooks, providers, and utilities that wrap @sodax/sdk with React Query. Pair it with @sodax/wallet-sdk-react for wallet connection.

[Full SDK reference →](https://docs.sodax.com/developers/packages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.