API Данные криптовалютного рынка Рейтинг токенов

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

Ранжируйте токены по рыночной капитализации, изменению за 24 часа или объёму торгов за 24 часа. При необходимости ограничьте результаты категорией, например MEME, AI или L2. Для каждого токена возвращаются цена, диапазон цен, рыночная капитализация, FDV, показатели предложения, а также исторические максимум и минимум.

Цена: $9.6 за 1 000 запросов ($0.009597 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Данные криптовалютного рынка Рейтинг токенов (crypto_market/token_ranking).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: crypto_market и action: token_ranking, а параметры передайте в params.
- Обязательных параметров нет.
- Необязательные параметры:
  - category: Ограничивает token_ranking одной категорией: MEME, AI, AI_AGENTS, L1, L2, DEFI, GAMING, STABLECOIN, RWA, DEPIN, SOL_ECO, BASE_ECO или LST. (допустимые значения: ai / ai_agents / base_eco / defi / depin / gaming / l1 / l2)
  - sort: Порядок token_ranking: market_cap (по умолчанию), change_24h (ранжирование среди топ-250 по рыночной капитализации) или volume_24h. (допустимые значения: change_24h / market_cap / volume_24h)
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: rank (Позиция в этом рейтинге, начиная с 1 (t…), slug (Короткое имя токена, например bitcoin (…), symbol (Символ токена, например BTC или USDT), name, price_usd (Цена в долларах США), change_24h_pct (Изменение цены за 24 часа в процентах (…), market_cap_usd (Рыночная капитализация по циркулирующем…), volume_24h_usd (Объём торгов за 24 часа в долларах США), high_24h_usd (Максимум за 24 часа в долларах США), low_24h_usd (Минимум за 24 часа в долларах США), fdv_usd (Полностью разводнённая оценка в доллара…), circulating_supply (Циркулирующее предложение); всего полей: 18, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=crypto_market.
- Пример тела запроса:
{
  "platform": "crypto_market",
  "action": "token_ranking",
  "params": {}
}
- Цена: $9.6 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`platform`	body	`string`	Да	`crypto_market`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`token_ranking`	Идентификатор возможности, фиксированное значение.
`category`	body.params	`string (enum)`	Нет	-	Ограничивает `token_ranking` одной категорией: MEME, AI, AI_AGENTS, L1, L2, DEFI, GAMING, STABLECOIN, RWA, DEPIN, SOL_ECO, BASE_ECO или LST.Допустимые значения`aiai_agentsbase_ecodefidepingamingl1l2lstmemerwasol_ecostablecoin`
`sort`	body.params	`string (enum)`	Нет	-	Порядок `token_ranking`: market_cap (по умолчанию), change_24h (ранжирование среди топ-250 по рыночной капитализации) или volume_24h.Допустимые значения`change_24hmarket_capvolume_24h`
`limit`	body.params	`integer (1–100)`	Нет	`20`	Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "crypto_market",
  "action": "token_ranking",
  "params": {}
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json

{
  "id": "req_…",
  "platform": "crypto_market",
  "action": "token_ranking",
  "results": [
    {
      "rank": …,
      "slug": …,
      "symbol": …,
      "name": …,
      "price_usd": …,
      "change_24h_pct": …,
      "market_cap_usd": …,
      "volume_24h_usd": …,
      "high_24h_usd": …,
      "low_24h_usd": …,
      "fdv_usd": …,
      "circulating_supply": …,
      "total_supply": …,
      "max_supply": …,
      "ath_usd": …,
      "ath_at": …,
      "atl_usd": …,
      "atl_at": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

Поле	Значение
`rank`	Позиция в этом рейтинге, начиная с 1 (token_ranking).
`slug`	Короткое имя токена, например bitcoin (token_ranking).
`symbol`	Символ токена, например BTC или USDT.
`name`	Название самого объекта для возможностей по аккаунтам, товарам и компаниям.
`price_usd`	Цена в долларах США.
`change_24h_pct`	Изменение цены за 24 часа в процентах (значение 0.76 означает +0,76 %).
`market_cap_usd`	Рыночная капитализация по циркулирующему предложению в долларах США.
`volume_24h_usd`	Объём торгов за 24 часа в долларах США.
`high_24h_usd`	Максимум за 24 часа в долларах США.
`low_24h_usd`	Минимум за 24 часа в долларах США.
`fdv_usd`	Полностью разводнённая оценка в долларах США.
`circulating_supply`	Циркулирующее предложение.
`total_supply`	Общее предложение.
`max_supply`	Максимальное предложение; отсутствует у токенов без ограничения эмиссии.
`ath_usd`	Исторический максимум цены в долларах США.
`ath_at`	Время исторического максимума, ISO 8601 UTC.
`atl_usd`	Исторический минимум цены в долларах США.
`atl_at`	Время исторического минимума, ISO 8601 UTC.
`platform`	Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки