API live · 3 nodes

Developer API

SwapTitan REST API: no-KYC swaps for 1,250+ coins, multi-chain RPC, AI agent and MCP server. Pay per call or subscribe.

10 swap calls/IP/day free5 AI calls/IP/day free50 RPC calls/IP trial

Quick Start

CLI v1.7.0

Swaps, wallet and AI agent from your terminal. Download it straight from us, no npm package needed.

curl -fsSL https://swaptitan.net/cli -o terafab
chmod +x terafab
npm i commander ethers
./terafab swap:quote -f btc -t sol -a 0.01

Node 18+. For Solana commands also: npm i @solana/web3.js bs58

JS SDK v1.1.0

Browser and Node.js, MCP client included, no build step.

<script src="https://swaptitan.net/agent-sdk.js"></script>
const sdk = new SwapTitanAgent();
sdk.quote("btc", "sol", 0.01).then(console.log);

MCP Server

Model Context Protocol: connect any AI agent via JSON-RPC 2.0. 23 tools.

POST https://swaptitan.net/mcp
{"jsonrpc":"2.0","method":"tools/list","id":1}

REST API Endpoints

/*sandbox*/ /*onionapi*/
MethodEndpointDescriptionPrice
GET/v1/riftbeam/quoteRiftBeam: own Solana aggregator (Raydium CLMM + Orca), Jupiter-compatible schema, drop-in by swapping the base URLfree
GET/v1/riftbeam/docsRiftBeam API docs and OpenAPI 3.1 (no login)free
GET/v1/riftbeam/healthRiftBeam indexer status and coveragefree
GET/v1/pricesLive prices BTC, ETH, SOL, XMR and morefree
GET/v1/assets1,250+ supported swap assetsfree
GET/v1/swap/quote?from=btc&to=sol&amount=0.01Quote with best-rate routingfree
GET/v1/swap/compare?from=sol&to=usdc&amount=1Live best-price comparison across own rails and partnersfree
POST/v1/swap/createCreate swap, returns deposit address10/day free · x402
GET/v1/swap/status?id=&provider=Poll swap: waiting, confirming, donefree
POST/v1/ai/chatAI agent: swaps, portfolio, rug check5/day free · x402
POST/v1/rpc/solSolana RPC, edge cachedtrial 50 · plan
POST/mcpMCP server: JSON-RPC 2.0, tools/list, tools/callfree
GET/v1/nowpayments/currencies300+ payable cryptosfree
GET/v1/nowpayments/estimate?amount=100&from=usd&to=btcFiat to crypto estimatefree
GET/v1/nowpayments/min?from=btc&to=xmrMinimum payment amount for a pairfree
GET/v1/private/quote?from=sol&to=btc&amount=1SwapTitan UnchainedSwap quote: private route A -> XMR -> B via two independent exchangesfree
POST/v1/swap/create (test mode)Sandbox: add "test":true (or header X-Test: 1) to any create call for a realistic response without a real order. Free and unlimited for testing.free
GEThttp://co476vm6yazusfjfeds7blfgpb5tyjj5e3nrx644emhzroi5gpjugvqd.onion/v1/… · /mcpTor: the full API and the MCP server (24 tools) are also served on our onion address. Tor exit traffic to the clearnet API is blocked, use the onion endpoints instead.free
POST/v1/private/createCreate an UnchainedSwap order {from,to,amount,address}; returns one-time deposit addressfree
POST/v1/nowpayments/paymentCreate crypto payment, returns pay address (AI-payable)free
GET/v1/nowpayments/status/:idPoll payment statusfree
POST/v1/ap4m/permissionRegister agent and set daily spending limitAP4M
GET/v1/ap4m/status?agent_id=Budget, daily spend, TX historyAP4M
POST/v1/ap4m/transactExecute swap with limit enforcement, rejected on exceedAP4M
POST/v1/ap4m/credentialAgentic token (HMAC-signed, 30-day expiry)AP4M

Base URL: https://api.swaptitan.net · EU mirror: https://api.terafabpay.de

SwapTitan UnchainedSwap & UnchainedWallet

UnchainedSwap is our private route: the swap runs in two legs at two independent exchanges with Monero in between. No single exchange knows both the deposit and the payout. Same-coin swaps (e.g. SOL to SOL) are supported to unlink funds.

curl "https://swaptitan.net/v1/private/quote?from=usdt&to=btc&amount=200"

curl -X POST https://swaptitan.net/v1/private/create \
  -H "Content-Type: application/json" \
  -d '{"from":"usdt","to":"btc","amount":200,"address":"bc1q..."}'

Response: payinAddress (one-time address), estimatedAmount, route of both legs and an order ID for /v1/swap/status. Usually 20–60 minutes.

UnchainedWallet is our non-custodial wallet (Solana, EVM, Bitcoin, Monero) in the browser and as an app. Agents get features and links through the MCP tool titanwallet, for example a prefilled swap link for the user. Agents never get access to keys.

Code examples

# Live prices (free)
curl https://api.swaptitan.net/v1/prices

# Swap quote (free)
curl "https://api.swaptitan.net/v1/swap/quote?from=btc&to=sol&amount=0.01"

# Create swap (10/day free, then x402)
curl -X POST https://api.swaptitan.net/v1/swap/create \
  -H "Content-Type: application/json" \
  -d '{"from":"btc","to":"sol","amount":0.01,"address":"YOUR_SOL_ADDR"}'

# AI agent (5/day free)
curl -X POST https://api.swaptitan.net/v1/ai/chat \
  -H "Content-Type: application/json" \
  -d '{"message":"How much SOL would I get for 0.1 BTC?"}'

AP4M · Agentic Payment Protocol

AP4M readyswaptitan.net/.well-known/agent.json · DMV: BOLT-F10-8130
  • x402 (Coinbase protocol)
  • USDC on Base and Solana
  • A2A Agent Card
  • MCP server (23 tools)
  • Spending limit enforcement
  • DMV verifiable identity
# Register agent with spending limit
curl -X POST https://api.swaptitan.net/v1/ap4m/permission \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my_agent_001","spending_limit_usdc":100,"currency":"USDC","chains":["base","solana"]}'

# Response
{"success":true,"agent_id":"my_agent_001","token":"ap4m_abc123...","spending_limit_usdc":100,"status":"active"}

x402 Pay-per-Call

When the free tier is used up, the API answers HTTP 402 with payment details. Your client signs a USDC payment on Base and retries with the X-Payment header. CLI and SDK do this automatically.

PAYMENT ADDRESS (Base)0xb973a20768a2a771ed89a9e8d0a03dcbb7de6eb4
PRICES (USDC on Base)swap/create $0.05 · ai/chat $0.025 · rpc $0.01 · oracle/allocation $0.02
# CLI: one-time setup, then every paid call is signed automatically
./terafab pay:setup <EVM_PRIVATE_KEY_WITH_USDC_ON_BASE>
./terafab swap -f btc -t sol -a 0.01 -d YOUR_SOL_ADDR

# 402 response when payment is needed
{ "x402Version":1, "accepts":[{ "scheme":"exact", "network":"base-mainnet",
  "payTo":"0xb973a20768a2a771ed89a9e8d0a03dcbb7de6eb4", "asset":"USDC" }] }

Need more than the free tier?

Plans from €2.49/month, paid with BTC, USDC or card. Instant license key.

View pricingContactsupport@terafabpay.de

FAQ

Do I need an API key?

No. Prices, assets and quotes are free without a key. Creating swaps is free for 10 calls per IP per day, AI chat for 5. After that you pay per call with x402 (USDC on Base) or use a plan from €2.49 per month.

How do I install the CLI?

Download it from swaptitan.net/cli, make it executable and install its two dependencies with npm i commander ethers. Node 18 or newer is required. No npm package from us is needed.

How do I connect an AI agent?

Point any MCP client to https://swaptitan.net/mcp (JSON-RPC 2.0). It exposes 23 tools for prices, quotes, best-route swaps, private Monero swaps, Solana and EVM swaps, wallets and rug checks.

What is x402?

An open pay-per-call standard. When the free tier is used up the API answers HTTP 402 with payment details. Your client signs a USDC payment on Base and retries with the X-Payment header. Our CLI and SDK do this automatically.