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

No API Key (Anonymous)
With API Key

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

Partners can authenticate using a Bearer token to access higher rate limits and revenue sharing:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.bestflow.xyz/coins

Benefits of API key authentication:

Higher Rate Limits: Bypass anonymous rate limits
Revenue Sharing: Qualify for swap volume revenue sharing

Rate Limits

Authentication	Rate Limit
Anonymous	20 requests/minute
API Key	Unlimited

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

Code	HTTP Status	Description
`VALIDATION_ERROR`	400	Invalid request parameters
`INVALID_FORMAT`	400	Malformed request data
`UNKNOWN_EXCHANGE`	400	Exchange not recognized
`UNAUTHORIZED`	401	Invalid or missing API key
`SWAP_NOT_FOUND`	404	Swap does not exist
`RATE_LIMITED`	429	Rate limit exceeded
`SWAP_ERROR`	502	Swap creation failed

Next Steps

List Supported Coins - View all available cryptocurrencies
Get Exchanges - List aggregated exchanges used for swaps
Estimate Rates - Compare rates across exchanges
Create a Swap - Execute a cryptocurrency swap
Check Swap Status - Track your swap progress

Need Help?

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

API documentation

Endpoints

Introduction

Welcome to Bestflow

Overview

Authentication

Rate Limits

Base URL

Quick Start

1. List Supported Coins

2. Get Rate Estimates

3. Create a Swap

Response Format

Error Codes

Next Steps

Need Help?

​Welcome to Bestflow

​Overview

​Authentication

​Rate Limits

​Base URL

​Quick Start

​1. List Supported Coins

​2. Get Rate Estimates

​3. Create a Swap

​Response Format

​Error Codes

​Next Steps

​Need Help?

Welcome to Bestflow

Overview

Authentication

Rate Limits

Base URL

Quick Start

1. List Supported Coins

2. Get Rate Estimates

3. Create a Swap

Response Format

Error Codes

Next Steps

Need Help?