API Reference

Developer API calls use X-Client-Id and X-API-Key. /v1/health is open. JSON errors use { "error": "message" }.

GET /v1/health

Open liveness endpoint. No API key required.

curl https://api.10fi.org/v1/health

GET /v1/quote

Param	Required	Meaning
chain	yes	Source chain slug.
toChain	no	Destination chain slug. If different from chain, 10FI uses a cross-chain route.
from	yes	Input token symbol or address.
to	yes	Output token symbol or address.
amount	yes	Human input amount, e.g. 100.
userAddress	recommended	Source wallet. Needed for executable quotes from some providers.
toAddress	cross-chain	Destination wallet; required for non-EVM destinations such as Solana or Tron.
gasless	no	Defaults to true. Set false if you prefer normal wallet transactions.

{
  "best": { "source": "velora-delta", "gasless": true, "amountOut": "..." },
  "quotes": [{ "source": "kyberswap" }],
  "all": [{ "source": "kyberswap" }],
  "comparison": { "bestSource": "velora-delta" },
  "warnings": []
}

POST /v1/swap

{
  "chain": "bsc",
  "toChain": "solana",
  "from": "USDT",
  "to": "SOL",
  "amount": "100",
  "userAddress": "0xSourceWallet",
  "toAddress": "SolanaDestination",
  "slippageBps": 50,
  "preferGasless": true
}

slippageBps must be 0-1000 bps (0-10%). The response is one of:

{ "type": "delta", "toSign": {}, "chainId": 56, "quote": {} }
{ "type": "onchain", "tx": { "to": "0x...", "data": "0x...", "value": "0" }, "quote": {} }
{ "type": "solana", "swapTransaction": "base64...", "lastValidBlockHeight": 123, "quote": {} }

POST /v1/submit

Submit a signature for a gasless Delta order.

{ "toSign": {}, "signature": "0x...", "chainId": 56, "userAddress": "0x..." }

GET /v1/status/:orderId

Poll a gasless order after /v1/submit.

GET /v1/bridge-status

Track a cross-chain transaction with txHash, fromChain and toChain.