AI / API
Открытый API для людей и ИИ-агентов
Бесплатные JSON-эндпоинты только для чтения поверх тех же данных, что на сайте. Без ключа, CORS открыт, лимит 60 запросов в минуту с одного IP. В каждом ответе указаны источник и время данных.
Поделиться разделом
Эндпоинты
| GET /api/v1 | JSON-индекс API: все ресурсы, частота обновления, источники, ссылки на /mcp и эту страницу |
| GET /api/v1/index | То же самое, что /api/v1 (прежний адрес) |
| GET /api/v1/price | Текущая цена BTC в USD и ещё 7 валютах (официальные курсы). |
| GET /api/v1/etf | Спотовые биткоин-ETF США: BTC, комиссия, потоки за день/5/20 дней/с запуска (млн $). |
| GET /api/v1/risk | Сводная оценка Risk On/Off (0–100) со всеми входами, формулами и источниками. |
| GET /api/v1/volatility | Реализованная волатильность за 7/30/90/365 дней и по годам. |
| GET /api/v1/holders | Держатели биткоина: компании, фонды, государства (BTC, изменение за 7 дней). |
| GET /api/v1/rainbow | Параметры радужной модели и текущее отклонение (модель, не прогноз). |
| GET /api/v1/stock-to-flow | Stock-to-flow и значение модели PlanB 2019 (модель, не прогноз). |
curl https://21btc.cc/api/v1/etf
Заголовки X-RateLimit-Limit / Remaining / Reset; при превышении — 429 и Retry-After. Ответы кешируются на 60 секунд.
Подключение к ИИ-агенту
Для MCP-клиентов есть готовый сервер только для чтения: /mcp (Streamable HTTP, те же данные плюс комиссии, деривативы, поиск и события). Для остальных агентов хватит одного HTTP-инструмента: опишите его так (формат function calling) или дайте агенту ссылку на эту страницу и на /llms.txt.
{
"name": "btc_data",
"description": "Read Bitcoin market data from 21btc.cc (price, etf, risk, volatility, holders, rainbow, stock-to-flow)",
"input_schema": {
"type": "object",
"properties": {
"resource": {
"type": "string",
"enum": [
"price",
"etf",
"risk",
"volatility",
"holders",
"rainbow",
"stock-to-flow"
]
}
},
"required": [
"resource"
]
},
"http": {
"method": "GET",
"url": "https://21btc.cc/api/v1/{resource}"
}
}Условия
- Бесплатно, с указанием 21btc.cc и первоисточников из ответа.
- Данные агрегированы из открытых источников и могут запаздывать; проверяйте поле as_of.
- Не инвестиционный совет. Модели (rainbow, stock-to-flow) — не прогнозы.
- Без гарантий доступности; формат v1 стабилен, новые поля могут добавляться.
FAQ
- Нужен ли API-ключ?
- Нет. Лимит — 60 запросов в минуту с одного IP-адреса.
- Откуда данные?
- Farside (потоки ETF), bitcointreasuries.net (держатели), alternative.me (страх и жадность), bitcoin-data.com (ончейн), blockchain.info и биржи (цены), ЕЦБ / ЦБ РФ (курсы валют). Источник указан в каждом ответе.