API Documentation

🌐

Base URL

https://api.cryptoswappro.io/v1

📄

Format

JSON (UTF-8)

🔐

Auth

API key in header: X-API-Key

⚡

Rate Limit

100 req/min (free), 1000/min (paid)

💰

Free Tier

100 requests/day, no credit card needed

📊

Uptime SLA

99.9% guaranteed on paid plans

coins	string	Optional comma-separated list of coin symbols (e.g. BTC,ETH,SOL)
vs_currency	string	Quote currency. Default: usd. Options: usd, eur, gbp

{
  "BTC": {
    "id": "bitcoin",
    "symbol": "BTC",
    "price": 94520.00,
    "change24h": 2.34,
    "volume24h": 28400000000,
    "marketCap": 1862000000000
  },
  "ETH": {
    "id": "ethereum",
    "symbol": "ETH", 
    "price": 3012.50,
    "change24h": -1.12
  }
}

from	string	Required. Source coin symbol (e.g. BTC)
to	string	Required. Destination coin symbol (e.g. ETH)
amount	number	Required. Amount to exchange in source coin

{
  "from": "BTC",
  "to": "ETH",
  "amount": 0.1,
  "rate": 31.42,
  "output": 3.142,
  "fee": 0.0001,
  "fee_usd": 9.45,
  "min": 0.001,
  "max": 100,
  "estimated_time": "30s"
}

from	string	Required. Source coin symbol
to	string	Required. Destination coin symbol
amount	number	Required. Amount to exchange
address	string	Required. Destination wallet address
refund_address	string	Optional. Refund address if exchange fails

{
  "order_id": "CSP-20251203-X7K9P",
  "status": "waiting",
  "deposit_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "deposit_amount": 0.1,
  "expected_output": 3.142,
  "expires_at": "2025-12-03T14:30:00Z"
}

order_id

string

Required. Order ID from /exchange response

{
  "order_id": "CSP-20251203-X7K9P",
  "status": "completed",
  "from": "BTC",
  "to": "ETH",
  "input_amount": 0.1,
  "output_amount": 3.138,
  "tx_out": "0xabc123...def456",
  "completed_at": "2025-12-03T13:32:18Z"
}

Free

$0/mo

✓ 100 req/day

✓ Price data only

✓ Community support

✓ No SLA

Starter

$49/mo

✓ 10,000 req/day

✓ All endpoints

✓ Email support

✓ 99.5% SLA

Pro

$199/mo

✓ 100,000 req/day

✓ Webhooks

✓ Priority support

✓ 99.9% SLA

💱 Exchange widget integration

Embed a custom-branded exchange interface into any website or app. Use /rate to get live quotes and /exchange to create orders. Your users never leave your platform, and you earn affiliate commission on every completed exchange.

📊 Live price feeds

The /prices endpoint returns prices for all 200+ supported coins every 60 seconds, aggregated from 30+ exchange sources. Use it to power price tickers, portfolio trackers, market overview dashboards, or any display that needs current crypto prices.

🔄 Automated rebalancing

Build automated portfolio management tools that swap between assets based on allocation targets. The API handles the exchange execution; your logic handles the when and how much. No KYC for amounts under $10,000/day means no identity bottleneck in your automation.

💳 Crypto payment acceptance

Accept any of 200+ cryptocurrencies as payment and auto-convert to USDT or BTC. The /exchange endpoint creates the receiving address; webhook notifications confirm when payment completes. Useful for e-commerce and subscription billing.

📱 Mobile app integration

Add exchange functionality to iOS or Android apps with a few API calls. No need to manage liquidity, custody, or compliance infrastructure — we handle all of it. Your app focuses on UX; we handle the exchange engine.

🤖 Trading bots

Use the live rate endpoint as a data source for arbitrage detection between CryptoSwapPro rates and other exchanges. The rate API includes mid-market prices and estimated execution rates useful for strategy backtesting.

What languages and frameworks does the API support?

The API is language-agnostic — it is a standard JSON REST API accessible via HTTP. Any language with an HTTP client works: Python (requests, httpx), JavaScript (fetch, axios), PHP (cURL, Guzzle), Go, Ruby, Java, C#, and others. No proprietary SDK is required, though we provide example code in Python and JavaScript above.

How are prices aggregated across 30+ exchanges?

Prices are fetched from exchange order books every 30–60 seconds and weighted by 24-hour volume. This volume-weighted average is more accurate than any single exchange price because it reflects where most actual trading is happening. Outliers more than 2 standard deviations from the mean are excluded to filter manipulation.

What is the rate limit?

Free tier: 100 requests/day. Starter: 10,000 requests/day (approximately 7 per minute sustained). Pro: 100,000 requests/day. All tiers apply a 100 requests/minute burst limit to prevent accidental spamming.

Are webhooks available?

Yes on Starter and Pro plans. Configure a webhook URL in your dashboard and we will send POST notifications when an exchange changes status (waiting → confirming → completed or failed). Payload is JSON with the full order object.