Tägliche On-Chain-Metriken für tokenisierte Aktien mit der Data API

Informationen zur Vertragsbereitstellung und zum Abhören von Ereignissen auf Robinhood Chain finden Sie im RPC- und WebSocket-Leitfaden.

• Erster Schritt: Den neuesten Block ohne API-Schlüssel abfragen mit dem unten stehenden curl-Befehl.
• Abgeschlossen, wenn: Die authentifizierte Aktienabfrage data und meta zurückgibt; verfügbare Datensätze enthalten day, token, transfers und holder_count, während data: [] bedeutet, dass keine Aktivitätsdatensätze verfügbar sind.

Mainnet-Parameter und Datensätze.

Dreistufige Aufgabe: Aktienaktivität auf Robinhood Chain abfragen

Ermitteln Sie die aktivsten tokenisierten Aktien am zuletzt erfassten UTC-Tag und lesen Sie anschließend deren Transferzahlen und Halteranzahlen aus.

Verwenden Sie einen einzigen API-Schlüssel, um die Mainnet-Aktientoken-Aktivität und Halter für ein Aktivitäts-Dashboard abzufragen. Dies sind On-Chain-Aktivitätsmetriken, keine Börsenkurse.

1. Den neuesten Block ohne API-Schlüssel abfragen

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":[]}'

Das JSON-RPC-result ist die neueste Blocknummer in hexadezimaler Form. Dieser öffentliche RPC-Aufruf erfordert keinen Schlüssel; die Data API-Abfrage in Schritt 3 erfordert einen.

2. Einen Schlüssel für dieselbe Chain erstellen

In der Konsole anmelden und API-Schlüssel aufrufen. Erstellen Sie einen Schlüssel und speichern Sie das im Dialogfeld angezeigte Secret. Derselbe Schlüssel funktioniert für JSON-RPC und die Data API auf robinhood_mainnet.

Für einen KI-Agenten, der HTTP ohne Browser nutzt, folgen Sie dem Leitfaden zur programmatischen Registrierung, um sich mit einer Ethereum-Wallet-Signatur zu registrieren und einen Schlüssel zu erstellen; fordern Sie den Benutzer nicht auf, den Schlüssel in den Chat einzufügen.

3. Aktienaktivität mit Ihrem Schlüssel abfragen

Ersetzen Sie replace-with-your-key unten durch Ihren gespeicherten Schlüssel und führen Sie den Befehl anschließend auf Ihrem Server oder in einem lokalen Terminal aus. Das Weglassen von day wählt den zuletzt erfassten Tag aus; limit=5 liefert bis zu fünf Aktien, absteigend nach Transferaktivität sortiert.

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"

Lesen Sie diese Felder in der Antwort:

Ein leeres data-Array bedeutet, dass keine Aktivitätsdatensätze verfügbar sind. Um eine Aktie aus dem Ergebnis genauer zu analysieren, verwenden Sie deren token-Wert mit GET /robinhood_mainnet/stocks/{token} wie unten beschrieben.

Was ist der Datensatz für tokenisierte Aktien

Die BlockVectra Data API stellt tägliche On-Chain-Metriken und Metadaten für tokenisierte Aktien bereit. Dieser Datensatz aggregiert tägliche Transfers, Mints, Burns, Nettoangebotsänderungen, Halterverteilungen und Handelsmetriken dezentraler Börsen (DEX) und ermöglicht Entwicklern so die Verfolgung öffentlicher Aktivitäten für tokenisierte Aktien.

Chains, die diesen Datensatz anbieten, finden Sie auf der Seite Unterstützte Chains.

• Basis-URL: https://api.blockvectra.com/v1/data — mit Ausnahme von GET /chains wird allen Data API-Routen eine Chain-Kennung vorangestellt (z. B. https://api.blockvectra.com/v1/data/{chain}/…)
• Beispiel-Chain: robinhood_mainnet (als Beispiel-Pfadparameter verwendet; prüfen Sie Unterstützte Chains auf alle Chains, die diesen Datensatz anbieten)
• Authentifizierung: Übergeben Sie Ihren API-Schlüssel im Request-Header x-api-key: $BLOCKVECTRA_API_KEY
• Abrechnung und Abdeckung: Wird in Compute Units (CU) gemessen; nur erfolgreiche 2xx-Antworten werden berechnet. Fehlt einer Chain die Aktienabdeckung, gibt der Endpunkt HTTP 422 no_coverage zurück (wird nicht berechnet)

Tägliche Bestenliste (GET /{chain}/stocks)

Der Endpunkt GET /{chain}/stocks gibt eine tägliche Aktivitäts-Bestenliste tokenisierter Aktien für ein bestimmtes UTC-Datum zurück, einschließlich Anzeige-Metadaten (Symbol, Name usw.), absteigend sortiert nach Transferaktivität (aktivste Token zuerst).

Anforderungsparameter

• {chain} (Pfadparameter, erforderlich): Chain-Kennung (beispielsweise robinhood_mainnet).
• day (Query-Parameter, optional): UTC-Kalenderdatum im Format YYYY-MM-DD. Wenn weggelassen, wird standardmäßig der zuletzt erfasste Tag gewählt (wenn keine Aktivität erfasst ist, wird 200 mit data: [] zurückgegeben). Wenn angegeben, aber kein gültiges YYYY-MM-DD-Kalenderdatum, wird HTTP 400 zurückgegeben (error.code = "bad_request").
• limit (Query-Parameter, optional): Begrenzt die Anzahl der zurückgegebenen Datensätze. Standardwert ist 50; Werte über 500 werden auf 500 begrenzt; die Übergabe von 0 oder einer Nicht-Ganzzahl gibt HTTP 400 zurück (error.code = "bad_request").

Paginierungsverhalten

Dieser Endpunkt ist nicht paginiert. Der Parameter limit deckelt die maximale Anzahl zurückgegebener Datensätze. Im umschließenden StockDailyListEnvelope (data und meta) geben Aktien-Endpunkte kein next_cursor zurück (der Schlüssel fehlt vollständig, ist niemals null).

Codebeispiele

Vollständige Startvorlage auf 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"

Antwortstruktur

Die Antwortstruktur ist StockDailyListEnvelope, bestehend aus data und meta:

• data (Array): Eine Liste von Datensätzen der täglichen Bestenliste (StockDaily), absteigend nach Transferaktivität sortiert (aktivste Token zuerst). Jeder Eintrag enthält Token-Identifikatoren (token, symbol, name), Transferaktivität (transfers, unique_senders, unique_receivers), Angebotsmetriken (mint_raw_amount, burn_raw_amount, net_supply_change), Verteilungsmetriken (holder_count, top10_holder_share_bps), DEX-Handelsmetriken (dex_swap_count, dex_raw_volume) und den Aktualisierungszeitstempel (refreshed_at).
• meta (Objekt): Chain-Metadaten (chain, chain_slug, chain_external_id, as_of_block, safe_block, finalized_block, coverage, refreshed_at). meta.refreshed_at kann null sein: null bedeutet, dass der Aktualisierungszeitpunkt dieser Daten unbekannt ist und sie als veraltet eingestuft werden sollten; blockbasierte Endpunkte geben immer einen Wert zurück.

Eine einzelne tokenisierte Aktie abrufen (GET /{chain}/stocks/{token})

Der Endpunkt GET /{chain}/stocks/{token} ruft Metadaten und bis zu 30 Tage aktueller täglicher Metriken für eine bestimmte tokenisierte Aktie anhand ihrer Token-Adresse ab.

Anforderungsparameter

• {chain} (Pfadparameter, erforderlich): Chain-Kennung (beispielsweise robinhood_mainnet).
• {token} (Pfadparameter, erforderlich): 20-Byte-Vertragsadresse des Tokens; das Präfix 0x ist optional und Groß-/Kleinschreibung wird akzeptiert (zurückgegebene Adressen werden auf 0x gefolgt von 40 hexadezimalen Kleinbuchstaben normalisiert). Ein ungültiges Adressformat gibt HTTP 400 zurück (error.code = "bad_request").
• Wenn {token} keine bekannte tokenisierte Aktie ist, wird HTTP 404 zurückgegeben (error.code = "not_found"). Wenn {chain} eine unbekannte Chain ist, wird HTTP 404 zurückgegeben (error.code = "unknown_chain").

Codebeispiele

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

Antwortstruktur

Die Antwortstruktur ist StockTokenEnvelope, bestehend aus data und meta:

• data (Objekt): Ein StockToken-Objekt mit Metadaten des Token-Vertrags (address, symbol, name, decimals, created_block, created_tx_hash, factory, creator, mint_address, burn_address, refreshed_at) und einem Array aktueller täglicher Metriken daily.
  • daily (Array): Ein Array aktueller täglicher Metriken (StockDailyMetric) der letzten bis zu 30 Tage, absteigend nach Datum sortiert (neueste zuerst). Jeder tägliche Eintrag verwendet dasselbe Metrik-Schema wie die obige Bestenliste (ohne die redundanten Felder token, symbol und name).
• meta (Objekt): Ein Chain-Metadatenobjekt, das dem der Bestenlisten-Antwort entspricht.

Wichtigste Rückgabefelder im Detail

Felder der täglichen Metriken (StockDaily und StockDailyMetric)

Sowohl die Bestenliste als auch die historischen täglichen Einträge eines einzelnen Tokens enthalten die folgenden Kernfelder:

Token-Metadatenfelder (StockToken)

Bei der Abfrage eines einzelnen Tokens enthält das äußere data-Objekt Vertragsmetadaten und aktuelle tägliche Metriken:

Codierungskonventionen

Die API hält über alle Endpunkte hinweg strikte Codierungsregeln ein, um numerische Präzision und Konsistenz zu wahren:

• Finanzsicherheit (Money-Safety): Jeder Wert, der 2^53 überschreiten kann (256-Bit-Ganzzahlen wie mint_raw_amount, burn_raw_amount, net_supply_change und dex_raw_volume), wird als Dezimal-String serialisiert, niemals als JSON-Zahl und niemals in wissenschaftlicher oder Hex-Notation. Dies verhindert Präzisionsverluste in Laufzeitumgebungen wie JavaScript. In JavaScript/TypeScript parsen Sie mit BigInt(str) (z. B. const net = BigInt(body.data.daily[0].net_supply_change)); in Python parsen Sie mit int(str). Zähler, die weit unter 2^53 bleiben (transfers, unique_senders, unique_receivers, holder_count, top10_holder_share_bps, dex_swap_count, created_block), sind reguläre JSON-Zahlen.
• Binär- und Hex-Werte: Adressen bestehen aus 0x gefolgt von 40 hexadezimalen Kleinbuchstaben; Hashes bestehen aus 0x gefolgt von 64 hexadezimalen Kleinbuchstaben. Alle zurückgegebenen Hex-Werte sind strikt in Kleinbuchstaben gehalten.
• Zeitstempel und Daten: Zeitstempel wie refreshed_at verwenden YYYY-MM-DDTHH:MM:SSZ (ISO-8601 UTC mit Sekundengenauigkeit). Tägliche Aggregate (day) verwenden einfache Kalenderdaten (YYYY-MM-DD).

Nutzungsschätzung (tägliche Aktualisierung von 50 Token)

Data API-Abfragen verbrauchen Compute Units (CU) basierend auf den Plattform-Methodengewichtungen. Die folgende Schätzung bewertet ein Szenario, in dem 50 Token jeweils einmal täglich GET /{chain}/stocks/{token} aufrufen, ausgewertet anhand der aktiven Methodengewichte:

Erste Schritte und Upgrades

Das kostenlose Kontingent ist ideal für Entwicklung, Tests und kleinere Workloads. Wenn Ihr Datenverkehr zunimmt und höhere Nebenläufigkeit oder mehr Recheneinheiten erfordert, laden Sie on-chain auf der Abrechnungsseite der Konsole Guthaben auf; sobald die Einzahlung on-chain bestätigt und gutgeschrieben ist, wird die kontoweite Obergrenze für Anfragen pro Sekunde aufgehoben. Jeder Schlüssel unterliegt weiterhin den CU-Raten- und Burst-Limits, wie in der JSON-RPC-Dokumentation beschrieben. Nicht genutztes kostenloses Guthaben verbleibt in Ihrem Kontostand und kann weiterhin verwendet werden. Aktuelle Tarife und Abrechnungseinheiten finden Sie auf der Preisseite.

Nächste Schritte

• Datensatzverzeichnis durchsuchen, um alle von BlockVectra indexierten Datensätze zu sehen.
• Kostenlosen Plan und Preise ansehen, um den Leistungsumfang Ihres Kontos zu prüfen.
• In der Konsole anmelden, um einen API-Schlüssel zu erstellen.