API Documentation

Chakra — swap routing across xy=k, stable, and CLMM venues on Arc Testnet.

github.com/mangekyou-labs/chakra · OpenAPI

Base URL
https://chakra-api-0a5i.onrender.com
Chain
Arc Testnet · 5042002 (0x4CEF52)
GET/api/v1/health

Health check (rate-limit exempt).

GET/api/v1/ready

Snapshot current AND at least one pool key in Redis.

GET/api/v1/tokens

Frozen catalog: ERC-20 USDC (6 dp), EURC (6 dp), cirBTC (8 dp). Native USDC is never listed.

GET/api/v1/balances

Catalog ERC-20 balances plus a separate native_usdc (18 dp gas) — never summed.

  • accountstring0x EVM address
GET/api/v1/quote

Best route. Integer price_impact_bps; protocol_fee_bps is 0.

  • token_instringERC-20 address (6/8 dp)
  • token_outstringERC-20 address
  • amount_instringAtomic amount (integer)
  • slippage_bpsnumber?Integer bps; default 50 (= 0.5%)
  • max_hopsnumber?Server default 3
  • max_splitsnumber?Clamped to server max
POST/api/v1/build_tx

splitSwap calldata + optional Permit2 typed data. Never a re-quoter.

  • userstring0x EOA address
  • token_instringInput token
  • token_outstringOutput token
  • amount_instringAtomic amount in
  • min_amount_outstringAtomic min out
  • sub_routesarrayFrom GET /quote

Calls GET /quote first so the sub-route steps match live routing, then POSTs build_tx with user.

  • xy=kUniswap V2 style · 30 bps
  • StableA=100 · 4 bps
  • CLMMUniswap V3 style · 30 bps