Skip to main content

​
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, then pick an API:

Swaps API

Quote, build intent, submit-tx, status — the full swap lifecycle over REST.

Leverage Yield API

Deposit into and withdraw from leveraged yield vaults.

Oracle API

USD price candles and live solver prices.

Stats API

Networks, partners, assets, filled-intent volume and SODA supply.
Base URLs and shared conventions are on the HTTP API overview. 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 walks through each call. Get an API key →

​
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 →