Các chỉ số on-chain hàng ngày cho cổ phiếu token hóa bằng Data API

Để triển khai hợp đồng và lắng nghe sự kiện trên Robinhood Chain, hãy làm theo hướng dẫn RPC và WebSocket.

Nhiệm vụ ba bước: truy vấn hoạt động cổ phiếu trên Robinhood Chain

Tìm các cổ phiếu token hóa hoạt động tích cực nhất vào ngày UTC gần nhất được ghi nhận, sau đó đọc số lượng chuyển giao và số lượng người nắm giữ của chúng.

Sử dụng một API key để truy vấn hoạt động của token cổ phiếu mainnet và người nắm giữ cho bảng điều khiển hoạt động. Đây là các chỉ số hoạt động on-chain, không phải báo giá cổ phiếu.

1. Đọc khối mới nhất không cần 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 của JSON-RPC là số hiệu khối mới nhất ở dạng thập lục phân. Lệnh gọi RPC công khai này không yêu cầu key; truy vấn Data API ở bước 3 yêu cầu một key.

2. Tạo key cho cùng chuỗi

Đăng nhập vào console và mở API Keys. Tạo một key và lưu secret hiển thị trong hộp thoại. Cùng một key hoạt động cho cả JSON-RPC và Data API trên robinhood_mainnet.

Đối với AI Agent sử dụng HTTP không cần trình duyệt, hãy làm theo hướng dẫn đăng ký theo chương trình để đăng ký bằng chữ ký ví Ethereum và tạo key; không yêu cầu người dùng dán key vào đoạn chat.

3. Truy vấn hoạt động cổ phiếu bằng key của bạn

Thay thế replace-with-your-key bên dưới bằng key đã lưu của bạn, sau đó chạy lệnh trên máy chủ hoặc trong terminal cục bộ. Việc bỏ qua day sẽ chọn ngày gần nhất được ghi nhận; limit=5 trả về tối đa năm cổ phiếu được sắp xếp theo hoạt động chuyển giao giảm dần.

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"

Đọc các trường này trong phản hồi:

Mảng data rỗng có nghĩa là không có bản ghi hoạt động nào khả dụng. Để kiểm tra một cổ phiếu từ kết quả, hãy sử dụng giá trị token của nó với GET /robinhood_mainnet/stocks/{token} như mô tả bên dưới.

Bộ dữ liệu cổ phiếu token hóa là gì

BlockVectra Data API cung cấp các chỉ số on-chain hàng ngày và siêu dữ liệu cho các cổ phiếu token hóa. Bộ dữ liệu này tổng hợp các giao dịch chuyển giao, mint, burn, thay đổi nguồn cung ròng, phân bổ người nắm giữ và các chỉ số giao dịch trên sàn giao dịch phi tập trung (DEX) hàng ngày, cho phép nhà phát triển theo dõi hoạt động công khai của các cổ phiếu token hóa.

Đối với các chuỗi cung cấp bộ dữ liệu này, hãy xem trang Chuỗi được hỗ trợ.

• URL cơ sở: https://api.blockvectra.com/v1/data — ngoại trừ GET /chains, tất cả các route của Data API đều có tiền tố là mã định danh chuỗi (ví dụ: https://api.blockvectra.com/v1/data/{chain}/…)
• Chuỗi ví dụ: robinhood_mainnet (được sử dụng làm tham số đường dẫn mẫu; hãy kiểm tra Chuỗi được hỗ trợ để biết tất cả các chuỗi cung cấp bộ dữ liệu này)
• Xác thực: Cung cấp API key của bạn trong header yêu cầu x-api-key: $BLOCKVECTRA_API_KEY
• Tính phí và độ bao phủ: Được tính bằng Compute Unit (CU); chỉ các phản hồi thành công 2xx mới bị tính phí. Nếu một chuỗi thiếu phạm vi dữ liệu cổ phiếu, endpoint sẽ trả về HTTP 422 no_coverage (không tính phí)

Bảng xếp hạng hàng ngày (GET /{chain}/stocks)

Endpoint GET /{chain}/stocks trả về bảng xếp hạng hoạt động hàng ngày của các cổ phiếu token hóa cho một ngày UTC cụ thể, bao gồm siêu dữ liệu hiển thị (symbol, name, v.v.), được sắp xếp theo hoạt động chuyển giao giảm dần (các token hoạt động nhiều nhất xuất hiện trước).

Tham số yêu cầu

• {chain} (tham số đường dẫn, bắt buộc): Mã định danh chuỗi (ví dụ: robinhood_mainnet).
• day (tham số truy vấn, tùy chọn): Ngày theo lịch UTC ở định dạng YYYY-MM-DD. Khi bỏ qua, mặc định là ngày gần nhất được ghi nhận (nếu không có hoạt động nào được ghi nhận, trả về 200 với data: []). Nếu được cung cấp nhưng không phải là ngày lịch YYYY-MM-DD hợp lệ, trả về HTTP 400 (error.code = "bad_request").
• limit (tham số truy vấn, tùy chọn): Giới hạn số lượng bản ghi trả về. Mặc định là 50; các giá trị trên 500 được cắt về 500; truyền 0 hoặc một giá trị không phải số nguyên trả về HTTP 400 (error.code = "bad_request").

Hành vi phân trang

Endpoint này không phân trang. Tham số limit giới hạn số lượng bản ghi tối đa được trả về. Trong khung phản hồi StockDailyListEnvelope (data và meta), các endpoint cổ phiếu không trả về next_cursor (key hoàn toàn không xuất hiện, không bao giờ là null).

Ví dụ mã nguồn

Starter template hoàn chỉnh trên 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"

Cấu trúc phản hồi

Khung phản hồi là StockDailyListEnvelope, chứa data và meta:

• data (mảng): Danh sách các bản ghi bảng xếp hạng hàng ngày (StockDaily), được sắp xếp theo hoạt động chuyển giao giảm dần (các token hoạt động nhiều nhất xuất hiện trước). Mỗi mục bao gồm các mã định danh token (token, symbol, name), hoạt động chuyển giao (transfers, unique_senders, unique_receivers), các chỉ số nguồn cung (mint_raw_amount, burn_raw_amount, net_supply_change), các chỉ số phân bổ (holder_count, top10_holder_share_bps), các chỉ số giao dịch DEX (dex_swap_count, dex_raw_volume), và timestamp làm mới (refreshed_at).
• meta (đối tượng): Siêu dữ liệu chuỗi (chain, chain_slug, chain_external_id, as_of_block, safe_block, finalized_block, coverage, refreshed_at). meta.refreshed_at có thể là null: null có nghĩa là thời gian cập nhật của dữ liệu này chưa xác định và dữ liệu nên được coi là cũ; các endpoint dựa trên khối luôn trả về một giá trị.

Lấy một cổ phiếu token hóa (GET /{chain}/stocks/{token})

Endpoint GET /{chain}/stocks/{token} lấy siêu dữ liệu và tối đa 30 ngày các chỉ số hàng ngày gần đây cho một cổ phiếu token hóa cụ thể theo địa chỉ token của nó.

Tham số yêu cầu

• {chain} (tham số đường dẫn, bắt buộc): Mã định danh chuỗi (ví dụ: robinhood_mainnet).
• {token} (tham số đường dẫn, bắt buộc): Địa chỉ hợp đồng token 20-byte; tiền tố 0x là tùy chọn và chấp nhận bất kỳ kiểu chữ hoa chữ thường nào (các địa chỉ trả về được chuẩn hóa thành 0x theo sau bởi 40 chữ số hex viết thường). Định dạng địa chỉ không hợp lệ trả về HTTP 400 (error.code = "bad_request").
• Nếu {token} không phải là một cổ phiếu token hóa đã biết, trả về HTTP 404 (error.code = "not_found"). Nếu {chain} là một chuỗi không xác định, trả về HTTP 404 (error.code = "unknown_chain").

Ví dụ mã nguồn

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

Cấu trúc phản hồi

Khung phản hồi là StockTokenEnvelope, chứa data và meta:

• data (đối tượng): Một đối tượng StockToken chứa siêu dữ liệu hợp đồng token (address, symbol, name, decimals, created_block, created_tx_hash, factory, creator, mint_address, burn_address, refreshed_at) và mảng chỉ số hàng ngày gần đây daily.
  • daily (mảng): Một mảng các chỉ số hàng ngày gần đây (StockDailyMetric), tối đa 30 ngày, được sắp xếp theo ngày giảm dần (mới nhất trước). Mỗi mục hàng ngày chia sẻ cùng một lược đồ chỉ số như bảng xếp hạng ở trên (không có các trường dư thừa token, symbol, và name).
• meta (đối tượng): Đối tượng siêu dữ liệu chuỗi nhất quán với phản hồi bảng xếp hạng.

Giải thích các trường trả về chính

Các trường chỉ số hàng ngày (StockDaily và StockDailyMetric)

Cả bảng xếp hạng và các mục hàng ngày lịch sử của một token đơn lẻ đều bao gồm các trường cốt lõi sau:

Các trường siêu dữ liệu token (StockToken)

Khi truy vấn một token đơn lẻ, đối tượng data bên ngoài chứa siêu dữ liệu hợp đồng và các chỉ số hàng ngày gần đây:

Quy ước mã hóa

API tuân thủ các quy tắc mã hóa nghiêm ngặt trên tất cả các endpoint để duy trì độ chính xác và tính nhất quán của số học:

• An toàn tiền tệ: Bất kỳ giá trị nào có thể vượt quá 2^53 (các số nguyên 256-bit như mint_raw_amount, burn_raw_amount, net_supply_change, và dex_raw_volume) đều được tuần tự hóa dưới dạng chuỗi số thập phân, không bao giờ là số JSON và không bao giờ ở dạng ký hiệu khoa học hoặc hex. Điều này ngăn ngừa việc mất độ chính xác trong các môi trường thực thi như JavaScript. Trong JavaScript/TypeScript, hãy phân tích cú pháp bằng BigInt(str) (ví dụ: const net = BigInt(body.data.daily[0].net_supply_change)); trong Python, phân tích cú pháp bằng int(str). Các bộ đếm duy trì thấp hơn nhiều so với 2^53 (transfers, unique_senders, unique_receivers, holder_count, top10_holder_share_bps, dex_swap_count, created_block) là các số JSON thông thường.
• Giá trị nhị phân và hex: Địa chỉ là 0x theo sau bởi 40 ký tự thập lục phân viết thường; hash là 0x theo sau bởi 64 ký tự thập lục phân viết thường. Tất cả các giá trị hex trả về đều nghiêm ngặt ở dạng chữ thường.
• Timestamp và ngày: Các timestamp như refreshed_at sử dụng YYYY-MM-DDTHH:MM:SSZ (ISO-8601 UTC với độ chính xác đến giây). Các tổng hợp hàng ngày (day) sử dụng ngày dương lịch thông thường (YYYY-MM-DD).

Ước tính mức sử dụng (làm mới 50 token mỗi ngày)

Các truy vấn Data API tiêu thụ Compute Unit (CU) dựa trên trọng số phương thức của nền tảng. Ước tính bên dưới đánh giá trường hợp 50 token mỗi ngày gọi GET /{chain}/stocks/{token} một lần, được tính toán dựa trên trọng số phương thức đang hoạt động:

Bắt đầu và nâng cấp

Hạn mức miễn phí rất lý tưởng cho việc phát triển, thử nghiệm và các khối lượng công việc nhẹ. Khi lưu lượng truy cập của bạn mở rộng và đòi hỏi mức độ tương tranh cao hơn hoặc nhiều Compute Unit hơn, hãy nạp tiền on-chain trên Trang thanh toán của console; sau khi được xác nhận on-chain và ghi có, giới hạn số lệnh gọi mỗi giây trên toàn tài khoản sẽ được gỡ bỏ. Mỗi key vẫn phải tuân theo giới hạn tốc độ và burst của CU, như được mô tả trong tài liệu JSON-RPC. Bất kỳ Tín dụng Miễn phí nào chưa sử dụng vẫn được giữ trong Tín dụng của bạn và vẫn có thể được sử dụng. Để biết mức giá và đơn vị thanh toán hiện tại, vui lòng xem Trang bảng giá.

Các bước tiếp theo

• Khám phá danh mục bộ dữ liệu để xem mọi bộ dữ liệu mà BlockVectra lập chỉ mục.
• Xem gói miễn phí và bảng giá để kiểm tra những gì tài khoản của bạn bao gồm.
• Đăng nhập vào console để tạo API key.