Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bestflow.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
Welcome to Bestflow

Bestflow is a cryptocurrency exchange aggregator that provides cross-chain swap capabilities without any additional fees. It aggregates multiple exchanges to offer users the best rates and seamless cryptocurrency swaps across different networks.

​
Overview

The Bestflow API enables developers to integrate cryptocurrency swap functionality into their applications. Key features include:
  • Cross-Chain Swaps: Seamlessly swap cryptocurrencies across different blockchain networks
  • Best Rate Aggregation: Automatically compares rates across multiple exchanges to find the best deal
  • Zero Additional Fees: No extra fees on top of exchange rates
  • Non-Custodial: You send directly to the exchange, receive directly to your wallet - we never hold your funds
  • Anonymous: No KYC, no registration, no wallet connection required. Swaps are private and untraceable - protected from MEV, tracking, and copytrading
  • Simple Integration: RESTful API with straightforward endpoints
You can call the API without a key (subject to rate limits). With an API key, partners get higher rate limits and can qualify for revenue sharing.

​
Authentication

The API supports anonymous calls without authentication. Anonymous users are subject to rate limiting:Rate Limit: 20 requests per minute
curl https://api.bestflow.xyz/coins

​
Rate Limits

AuthenticationRate Limit
Anonymous20 requests/minute
API KeyUnlimited
When rate limited, the API returns a 429 status with: 
{
  "error": "RATE_LIMITED",
  "message": "Too many requests. Limit: 100 req/min. Retry after 60s."
}

​
Base URL

All API requests should be made to: 
https://api.bestflow.xyz

​
Quick Start

​
1. List Supported Coins

curl https://api.bestflow.xyz/coins

​
2. Get Rate Estimates

curl -X POST https://api.bestflow.xyz/rate \
  -H "Content-Type: application/json" \
  -d '{
    "from": "BTC",
    "to": "ETH",
    "fromNetwork": "BTC",
    "toNetwork": "ETH",
    "amount": 0.5
  }'

​
3. Create a Swap

curl -X POST https://api.bestflow.xyz/swap \
  -H "Content-Type: application/json" \
  -d '{
    "exchange": "swapter",
    "from": "BTC",
    "to": "ETH",
    "fromNetwork": "BTC",
    "toNetwork": "ETH",
    "toAddress": "0x...",
    "amount": 0.5
  }'

​
Response Format

All responses are returned in JSON format. Successful responses return the requested data directly. Error responses follow this structure: 
{
  "error": "ERROR_CODE",
  "message": "Human-readable error description"
}

​
Error Codes

CodeHTTP StatusDescription
VALIDATION_ERROR400Invalid request parameters
INVALID_FORMAT400Malformed request data
UNKNOWN_EXCHANGE400Exchange not recognized
UNAUTHORIZED401Invalid or missing API key
SWAP_NOT_FOUND404Swap does not exist
RATE_LIMITED429Rate limit exceeded
SWAP_ERROR502Swap creation failed

​
Next Steps

​
Need Help?

If you have questions or need assistance integrating the Bestflow API, please contact our support team.