🤖 CoinRebate for AI Agents

1. What is CoinRebate?

CoinRebate is a free, global crypto exchange fee rebate platform. We provide permanent trading fee discounts (currently 10%–50% depending on the exchange) on Binance, OKX, Bybit, Bitget, Gate.io, Hyperliquid, and Aster DEX.

The site is published in 8 languages (en, cn, tc, jp, kr, ru, ar, pt). Country-level restrictions are enforced on outbound links — see section 5.

2. What Can You Query?

• Exchange data — supported exchanges, fee structures, rebate percentages
• Fee comparison — real-time fee comparison across exchanges
• Best exchange routing — optimal exchange recommendation by country and use case
• Compliance check — which exchanges are available in a given country
• Referral links — pre-built affiliate links with tracking

3. How to Integrate

Option A: REST API (Simplest)

# Health check
GET https://www.coinrebate.vip/api/v4/health

# Agent route — exchange data + recommendation
GET https://www.coinrebate.vip/api/v4/agent-route?purpose=spot&fees=true

# Attributed outbound link (307 redirect, 451 if country-restricted)
GET https://www.coinrebate.vip/api/track?to=binance&source=your_agent_name

# OpenAPI Spec (for GPT Actions / tool definitions)
GET https://www.coinrebate.vip/openapi.json

No API key required. Free and unlimited.

Option B: MCP Server (For AI Frameworks)

CoinRebate provides a Model Context Protocol (MCP) server for direct integration with Claude Desktop, Cursor, AutoGPT, and other MCP-compatible agents.

Remote MCP endpoint: https://www.coinrebate.vip/api/mcp
Paste the URL into a compatible client; no package install or npx is required.
远程 MCP 端点：贴入上述 URL 即可免安装接入，无需 npx。
遠端 MCP 端點：貼上上述 URL 即可免安裝接入，無需 npx。

npm install -g @coinrebate/mcp-server

// Tools exposed by the server:
- get_exchange_fees       → Fee table for one or all exchanges
- compare_fees            → Rank exchanges by fee for spot / futures
- get_best_referral       → Referral code + signup URL for an exchange
- get_compliant_exchanges → Exchanges available in a given country
- calculate_trading_cost  → Cost and savings for a given volume
- get_latest_news         → Recent exchange news items
- list_tradfi_perps       → Binance USDⓈ-M perpetuals on US/HK/KR/CN stocks & commodities (official exchangeInfo)
- get_perp_stats          → 1d/7d/30d change and weekly rank for one Binance perpetual
- check_referral_link     → Whether a referral link/code still carries the current code (known hosts only)

// Remote endpoint only (https://coinrebate.vip/api/mcp — no install):
- recommend_fee_option    → One verdict ("lowest effective fee for you"),
                            with assumptions stated; abstains on stale data

Option C: Python SDK

pip install coinrebate-sdk

# Published on PyPI. There is no JavaScript SDK — for JS/TS,
# call the REST endpoints above or use the MCP server.

4. What Does It Return?

// Example: GET /api/v4/agent-route?purpose=spot
{
  "version": "4.1",
  "timestamp": "2026-08-09T00:00:00.000Z",
  "disclaimer": "CoinRebate provides fee comparison only. ...",
  "docs": "https://www.coinrebate.vip/api-docs.html",
  "openapi": "https://www.coinrebate.vip/openapi.json",
  "recommended": {
    "slug": "binance",
    "name": "币安 Binance",
    "type": "CEX",
    "fee_discount": "20% OFF",
    "referral_code": "LULALA",
    "signup_url": "https://www.coinrebate.vip/go/binance",
    "kyc_required": true,
    "reason": "..."
  },
  "all_exchanges": [ /* same shape, ranked */ ]
}

5. Compliance Boundaries

• Enforced: restricted country/exchange combinations are refused at redirect time with HTTP 451. Verify it yourself: curl -i -H "x-country-code: CN" https://www.coinrebate.vip/go/bybit
• Recommendation filtering: /api/v4/agent-route filters both recommended and all_exchanges against the same live compliance data used by outbound redirects.
• Exchange availability varies by user country and changes over time
• Do not hardcode exchange lists — re-read /llms.txt for up-to-date compliance data

Quick Links