Щоденні ончейн-показники для токенізованих акцій за допомогою Data API

Щодо розгортання контрактів та прослуховування подій у Robinhood Chain звертайтеся до посібника з RPC та WebSocket.

• Перший крок: Прочитайте останній блок без API key за допомогою команди curl нижче.
• Критерій завершення: автентифікований запит до stocks повертає data та meta; доступні записи містять day, token, transfers та holder_count, тоді як data: [] означає відсутність доступних записів активності.

Параметри основної мережі та набори даних.

Завдання у три кроки: запит активності акцій у Robinhood Chain

Знайдіть найактивніші токенізовані акції за останній зафіксований день за UTC, а потім зчитайте кількість їхніх переказів та власників.

Використовуйте один API key для запиту активності та власників токенів акцій в основній мережі для створення панелі активності. Це показники ончейн-активності, а не біржові котирування акцій.

1. Прочитайте останній блок без API key

curl -sS "https://api.blockvectra.com/v1/robinhood_mainnet/public" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Поле result відповіді JSON-RPC містить номер останнього блоку в шістнадцятковому форматі. Цей публічний виклик RPC не вимагає ключа; запит до Data API на кроці 3 потребує його.

2. Створіть ключ для тієї самої мережі

Увійдіть до консолі та відкрийте API Keys. Створіть ключ і збережіть secret, показаний у діалоговому вікні. Один і той самий ключ підходить для JSON-RPC і Data API на robinhood_mainnet.

Для AI-агента, який використовує HTTP без браузера, дотримуйтесь посібника з програмної реєстрації, щоб зареєструватися за допомогою підпису Ethereum-гаманця та створити ключ; не просіть користувача вставляти ключ у чат.

3. Запитайте активність акцій за допомогою вашого ключа

Замініть replace-with-your-key нижче на ваш збережений ключ, після чого виконайте команду на вашому сервері або в локальному терміналі. Пропуск day вибирає останній зафіксований день; limit=5 повертає до п'яти акцій, відсортованих за спаданням активності переказів.

export BLOCKVECTRA_API_KEY='replace-with-your-key'

curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?limit=5" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Зверніть увагу на такі поля у відповіді:

Порожній масив data означає відсутність доступних записів активності. Щоб перевірити конкретну акцію з результату, використовуйте її значення token у запиті GET /robinhood_mainnet/stocks/{token}, як описано нижче.

Що являє собою набір даних токенізованих акцій

BlockVectra Data API надає щоденні ончейн-показники та метадані для токенізованих акцій. Цей набір даних агрегує щоденні перекази, випуски (mints), спалювання (burns), чисті зміни пропозиції, розподіл власників та показники торгівлі на децентралізованих біржах (DEX), дозволяючи розробникам відстежувати публічну активність токенізованих акцій.

Список мереж, які пропонують цей набір даних, наведено на сторінці Підтримувані мережі.

• Базовий URL: https://api.blockvectra.com/v1/data — за винятком GET /chains, усі маршрути Data API мають префікс ідентифікатора мережі (наприклад, https://api.blockvectra.com/v1/data/{chain}/…)
• Приклад мережі: robinhood_mainnet (використовується як приклад параметра шляху; перевірте Підтримувані мережі для всіх мереж, що надають цей набір даних)
• Автентифікація: передавайте ваш API key у заголовку запиту x-api-key: $BLOCKVECTRA_API_KEY
• Білінг та покриття: тарифікується в Compute Units (CU); тарифікуються лише успішні відповіді 2xx. Якщо в мережі відсутнє покриття акцій, ендпоінт повертає HTTP 422 no_coverage (не тарифікується)

Щоденна таблиця лідерів (GET /{chain}/stocks)

Ендпоінт GET /{chain}/stocks повертає щоденну таблицю лідерів активності токенізованих акцій за вказану дату UTC, включно з метаданими для відображення (символ, назва тощо), відсортовану за спаданням активності переказів (найактивніші токени першими).

Параметри запиту

• {chain} (параметр шляху, обов'язковий): ідентифікатор мережі (наприклад, robinhood_mainnet).
• day (параметр запиту, необов'язковий): календарна дата за UTC у форматі YYYY-MM-DD. Якщо пропущено, за замовчуванням вибирається останній зафіксований день (якщо активність не зафіксована, повертає 200 із data: []). Якщо передано недійсну календарну дату YYYY-MM-DD, повертає HTTP 400 (error.code = "bad_request").
• limit (параметр запиту, необов'язковий): обмежує кількість повернених записів. За замовчуванням — 50; значення понад 500 обмежуються до 500; передача 0 або нецілого числа повертає HTTP 400 (error.code = "bad_request").

Поведінка пагінації

Цей ендпоінт не підтримує пагінацію. Параметр limit обмежує максимальну кількість повернених записів. В охоплюючому об'єкті StockDailyListEnvelope (data та meta) ендпоінти акцій не повертають next_cursor (ключ взагалі відсутній, а не null).

Приклади коду

Повний стартовий шаблон для Robinhood Chain: blockvectra/robinhood-stock-tokens

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Структура відповіді

Обгорткою відповіді є StockDailyListEnvelope, що містить data та meta:

• data (масив): список записів щоденної таблиці лідерів (StockDaily), відсортований за спаданням активності переказів (найактивніші токени першими). Кожен елемент містить ідентифікатори токена (token, symbol, name), показники активності переказів (transfers, unique_senders, unique_receivers), показники пропозиції (mint_raw_amount, burn_raw_amount, net_supply_change), показники розподілу (holder_count, top10_holder_share_bps), показники торгівлі на DEX (dex_swap_count, dex_raw_volume) та часову мітку оновлення (refreshed_at).
• meta (об'єкт): метадані мережі (chain, chain_slug, chain_external_id, as_of_block, safe_block, finalized_block, coverage, refreshed_at). Поле meta.refreshed_at може бути null: null означає, що час оновлення цих даних невідомий і їх слід вважати застарілими; ендпоінти на основі блоків завжди повертають значення.

Отримання однієї токенізованої акції (GET /{chain}/stocks/{token})

Ендпоінт GET /{chain}/stocks/{token} повертає метадані та до 30 днів останніх щоденних показників для конкретної токенізованої акції за адресою її токена.

Параметри запиту

• {chain} (параметр шляху, обов'язковий): ідентифікатор мережі (наприклад, robinhood_mainnet).
• {token} (параметр шляху, обов'язковий): 20-байтна адреса контракту токена; префікс 0x необов'язковий, підтримується будь-який регістр (повернені адреси нормалізуються до 0x, за яким слідують 40 малих шістнадцяткових цифр). Недійсний формат адреси повертає HTTP 400 (error.code = "bad_request").
• Якщо {token} не є відомою токенізованою акцією, повертає HTTP 404 (error.code = "not_found"). Якщо {chain} є невідомою мережею, повертає HTTP 404 (error.code = "unknown_chain").

Приклади коду

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/0x1111111111111111111111111111111111111111" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Структура відповіді

Обгорткою відповіді є StockTokenEnvelope, що містить data та meta:

• data (об'єкт): об'єкт StockToken, що містить метадані контракту токена (address, symbol, name, decimals, created_block, created_tx_hash, factory, creator, mint_address, burn_address, refreshed_at) та масив нещодавніх щоденних показників daily.
  • daily (масив): масив нещодавніх щоденних показників (StockDailyMetric), до 30 днів, відсортований за датою у спадному порядку (найновіші першими). Кожен щоденний елемент має ту саму схему показників, що й наведена вище таблиця лідерів (без надлишкових полів token, symbol та name).
• meta (об'єкт): об'єкт метаданих мережі, узгоджений із відповіддю таблиці лідерів.

Опис ключових повернених полів

Поля щоденних показників (StockDaily та StockDailyMetric)

Як елементи таблиці лідерів, так і щоденні історичні записи окремого токена містять такі основні поля:

Поля метаданих токена (StockToken)

Під час запиту окремого токена зовнішній об'єкт data містить метадані контракту та нещодавні щоденні показники:

Конвенції кодування

API дотримується суворих правил кодування для всіх ендпоінтів заради збереження числової точності та узгодженості:

• Безпека грошових сум: будь-яке значення, яке може перевищувати 2^53 (256-бітні цілі числа, такі як mint_raw_amount, burn_raw_amount, net_supply_change та dex_raw_volume), серіалізується як десятковий рядок, ніколи не як число JSON і ніколи в науковій чи шістнадцятковій нотації. Це запобігає втраті точності в таких середовищах, як JavaScript. У JavaScript/TypeScript парсіть за допомогою BigInt(str) (наприклад, const net = BigInt(body.data.daily[0].net_supply_change)); у Python парсіть за допомогою int(str). Лічильники, що залишаються значно нижче 2^53 (transfers, unique_senders, unique_receivers, holder_count, top10_holder_share_bps, dex_swap_count, created_block), є звичайними числами JSON.
• Двійкові та шістнадцяткові значення: адреси мають вигляд 0x, за яким слідують 40 малих шістнадцяткових символів; хеші мають вигляд 0x, за яким слідують 64 малі шістнадцяткові символи. Усі повернені шістнадцяткові значення подаються виключно в нижньому регістрі.
• Часові мітки та дати: такі мітки, як refreshed_at, використовують формат YYYY-MM-DDTHH:MM:SSZ (ISO-8601 UTC із точністю до секунд). Щоденні агрегати (day) використовують прості календарні дати (YYYY-MM-DD).

Оцінка використання (щоденне оновлення 50 токенів)

Запити до Data API споживають Compute Units (CU) на основі ваг методів платформи. Наведена нижче оцінка розглядає сценарій, у якому для 50 токенів виконується виклик GET /{chain}/stocks/{token} один раз на день за активними вагами методів:

Початок роботи та оновлення тарифу

Безкоштовна квота ідеально підходить для розробки, тестування та помірних робочих навантажень. Коли ваш трафік зростає та вимагає вищого рівня паралелізму або більшої кількості compute units, поповніть баланс ончейн на сторінці Білінг у консолі; після підтвердження ончейн та зарахування коштів ліміт викликів на секунду для всього акаунта знімається. Кожен ключ залишається обмеженим лімітами швидкості CU та сплесків, як описано в документації JSON-RPC. Усі невикористані безкоштовні кредити залишаються у ваших Credits і все ще можуть використовуватися. Актуальні тарифи та одиниці білінгу дивіться на сторінці Ціни.

Наступні кроки

• Перегляньте каталог наборів даних, щоб ознайомитися з усіма наборами даних, які індексує BlockVectra.
• Перегляньте безкоштовний план і ціни, щоб дізнатися, що включено у ваш акаунт.
• Увійдіть до консолі, щоб створити API key.