Quick start

API Keys

Two key types are available:

Key Type	Requests/Minute	Commission
Free	20	0%
Standard	60	From feeShareBps param

Pass the key in the api-key header with each request.

API is accessible without a key (20 req/min), but a key is required for higher rate limits and commission earning.

Test keys:

• Free: test-sdk-test-sdk-test-sdk-free

• Standard: test-sdk-test-sdk-test-sdk-standard

Production keys: @Eywa_BDLead / [email protected]

---

Example: USDC from Arbitrum to Ethereum

1. Get Route

curl -X POST "https://api.crosscurve.fi/routing/scan" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_KEY" \
  -d '{
    "params": {
      "chainIdIn": 42161,
      "chainIdOut": 1,
      "tokenIn": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "amountIn": "1000000000"
    },
    "slippage": 1
  }'

Response contains an array of routes with fees, expected amount, and execution time. Use the first route routes[0].

2. Create Transaction

curl -X POST "https://api.crosscurve.fi/tx/create" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "0xYourWallet",
    "recipient": "0xYourWallet",
    "routing": <route object from step 1>,
    "buildCalldata": true
  }'

Response { to, value, data } is ready to send via any Web3 library.

3. Send Transaction

// Approve token to the contract
await tokenContract.approve(txData.to, amount);

// Send transaction
const tx = await signer.sendTransaction(txData);

4. Track Status

# Find requestId by transaction hash
curl "https://api.crosscurve.fi/search?search=0xYourTxHash"

# Check status (poll every 5 sec)
curl "https://api.crosscurve.fi/transaction/{requestId}"

Status completed means successful completion.

---

Reference Endpoints

Endpoint	Returns
GET /networks	List of supported networks with chainId
GET /tokenlist	Tokens by network (need can_swap tag for swaps)
GET /prices/{address}/{chainId}	Token price in USD

---

Next Steps

• Full API Documentation — all endpoints and parameters

• TypeScript SDK — Viem, Ethers, Web3

• Swagger UI — interactive testing

• Partner Program — fee sharing terms

---

Questions? Contact us: @Eywa_BDLead