The Coinbell API
The same data that runs this site, as simple JSON: prices, USDT P2P rates in 30+ currencies, funding, liquidation heatmaps, whale transfers and market indicators. Free to start, with higher limits on Pro.
Your API keys
Quick start
- Create a key here (you need a free account).
- Send it in the
x-api-keyheader with every request. - Every answer is JSON inside
data.
curl -H "x-api-key: YOUR_KEY" https://coinbell.org/v1/p2p/lkr
Base URL: https://coinbell.org/v1. Read-only, HTTPS only, CORS open so it works from the browser too (but keep your key out of public pages).
Limits
| Free | Pro |
|---|
Limits count per key and reset at 00:00 UTC. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. See Pro pricing.
Endpoints
| Request | What you get | |
|---|---|---|
| Market data | ||
GET /v1/markets | Top 100 coins: price, market cap, volume, 1h / 24h / 7d change, ATH Parameters: limit (1–100), sparkline=true | |
GET /v1/coins/{id} | One coin in detail (CoinGecko id, for example bitcoin) | |
GET /v1/global | Total market cap, volume and dominance | |
GET /v1/fear-greed | Fear & Greed index today | |
GET /v1/news | Latest headlines from 10 publications Parameters: topic, coin, limit (1–50) | |
GET /v1/listings | New spot and futures listings on Binance, Bybit, OKX and KuCoin | |
GET /v1/calendar | Fed meetings, options expiries and the next halving | |
| USDT and P2P | ||
GET /v1/p2p/{fiat} | Best buy and sell USDT prices on Binance and Bybit P2P, bank rate and offers (for example lkr)PRO Free: top 5 offers · Pro: top 20 | |
GET /v1/p2p/{fiat}/history | Rate history: [time, best buy, best sell, bank rate] Parameters: daysPRO Free: 30 days · Pro: 365 | |
GET /v1/usdt-premium | USDT premium over the bank rate in every currency | |
GET /v1/fees | Cost of sending USDT on 8 networks, plus Bitcoin fees | |
GET /v1/whales | USDT transfers of $1M+ on TRON, Ethereum and BNB Chain Parameters: network (tron, ethereum, bsc), min (USD) | |
| Derivatives and analytics | ||
GET /v1/futures | Funding rates, open interest and liquidations | |
GET /v1/funding-arbitrage | Funding rate of each coin on 5 exchanges, with the gap | |
GET /v1/liquidation-map | Estimated liquidation heatmap (grid is base64, square-root scaled 0–255) Parameters: coin (BTC, ETH, SOL…), range (24h, 3d, 7d, 30d)PRO Free: 24h · Pro: all ranges | |
GET /v1/rsi | Daily and 4-hour RSI for the top coins | |
GET /v1/altseason | Altcoin season index with 90-day history | |
GET /v1/bitcoin-cycle | Mayer multiple, 200-week average, Pi cycle, halving progress | |
GET /v1/correlations | 30 and 90-day correlation with Bitcoin, and a matrix | |
JavaScript
const res = await fetch('https://coinbell.org/v1/markets?limit=10', {
headers: { 'x-api-key': 'YOUR_KEY' },
});
const { data } = await res.json();
console.log(data.coins.map((c) => `${c.symbol}: $${c.price}`));Python
import requests
r = requests.get("https://coinbell.org/v1/usdt-premium",
headers={"x-api-key": "YOUR_KEY"}, timeout=10)
for row in r.json()["data"]["rows"]:
print(row["code"], round(row["premium"] or 0, 2), "%")Response format
{
"data": { ... },
"attribution": "Data from Coinbell (https://coinbell.org)",
"plan": "free"
}
Errors come back as { "error": "…" } with a normal HTTP status: 400 bad input, 401 missing or wrong key, 402 needs Pro, 429 over the limit, 502 the upstream source is down.
Fair use
- Show where the data is from. On the free plan, link to coinbell.org near the data.
- Cache what you can. Most data changes every 1–10 minutes, so there is no need to ask every second.
- Don't resell the raw data or build a copy of this API from it.
- Keep keys secret. If one leaks, delete it and make a new one.
Questions
- Is the API really free?
- Yes. A free account gets 1,000 requests a day, which is plenty for a bot, a spreadsheet or a small website. Pro raises that to 50,000 a day and unlocks the bigger datasets.
- Where does the data come from?
- P2P rates come from Binance and Bybit P2P, whale transfers straight from the TRON, Ethereum and BNB Chain blockchains, prices from CoinGecko and Binance, and funding from the exchanges via CoinGecko. The indicators are calculated by Coinbell.
- Can I use it in a Telegram bot or a trading script?
- Yes. That is what it is for. Remember it is information, not advice, and data can be delayed or briefly unavailable.
- How fresh is the data?
- Prices update about every 90 seconds, P2P rates every few minutes, whale transfers every minute and the indicators every 30 to 60 minutes.