Desteklenen Zincirler

BlockVectra, çok zincirli bir blokzincir veri sağlayıcısıdır: Desteklediğimiz her zincirde JSON-RPC ve kullanılabilir olduğu yerlerde Data API.

Tek anahtar, tüm zincirler

• Evrensel anahtar: Aynı API key, BlockVectra'nın desteklediği her blokzincir ağında çalışır — zincir başına ayrı anahtarlar gerekmez.
• URL'de zincir: Her istek, {chain} yol bölümü aracılığıyla zincirini açıkça belirtir.
• Birleştirilmiş kullanım: Hesap bakiyesi, Compute Unit (CU) hız sınırı havuzları ve ücretsiz katmandaki saniye başına istek sınırları tüm zincirler arasında paylaşılır.
• Fiyatlandırma: Bkz. Fiyatlandırma.

Bir API anahtarı olmadan deneyin

Bir API key olmadan cüzdan yöntemleri için ücretsiz bir genel RPC uç noktası seçin. Genel yöntemler ve IP başına sınırlar ağ başına listelenmiştir; çağrı örneği için Hızlı Başlangıç sayfasına bakın.

URL şablonları

JSON-RPC ve Data API'yi çağırmak için standart URL yapıları:

Not: Zincir bölümü olmayan bir istek (örneğin POST /v1 veya POST /v1/), boş bir gövdeyle HTTP 404 döndürür. Kurulum ayrıntıları için Hızlı Başlangıç sayfasına bakın.

Desteklenen zincirler matrisi

BlockVectra'da şu anda mevcut olan blokzincir ağları ve bunların hizmet yetenekleri:

Uç noktalar, bir API key ile kullanılabilen yöntemler, abonelikler, işlem gönderme, durum ve log sınırları, veri kümeleri, ilgili testnet'ler ve rehberler zincir başına gösterilir. Bilinmeyen olgular bilinmiyor olarak kalır. O zincir tarafından desteklenen istekler için matrisin altındaki bir zinciri genişletin.

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/arb_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/arb_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/arb_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/base_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/base_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/base_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/bsc_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/bsc_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/bsc_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/eth_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/eth_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/eth_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/eth_sepolia' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/eth_sepolia' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/eth_sepolia/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/hyperevm_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/hyperevm_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/hyperevm_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/polygon_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/polygon_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/polygon_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/robinhood_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/robinhood_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

curl -fsS 'https://api.blockvectra.com/v1/data/robinhood_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

echo '{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}' | websocat --no-close -H="x-api-key: $BLOCKVECTRA_API_KEY" 'wss://api.blockvectra.com/v1/robinhood_mainnet'

set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/robinhood_testnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/robinhood_testnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

echo '{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}' | websocat --no-close -H="x-api-key: $BLOCKVECTRA_API_KEY" 'wss://api.blockvectra.com/v1/robinhood_testnet'

Ethereum

• Chain ID: 1
• Zincir adı (URL'lerde {chain}): eth_mainnet, örneğin POST /v1/eth_mainnet/{api_key} veya GET /v1/data/eth_mainnet/….

JSON-RPC

• Yöntemler: Her zincir için kullanılabilir yöntemler GET /v1/chains içindeki methods.allow / deny ile belirlenir (bkz. Yöntem Politikası); bu kapsam dışındaki yöntemler -32601 döndürür.
• Yalnızca yakın geçmiş verileri: Geçmiş durum penceresi, GET /v1/chains içindeki state_window_blocks ile belirlenir. Pencere dışındaki geçmiş durum sorguları -32011 döndürür (faturalandırılmaz); pencere dışındaki blok, makbuz ve log sorguları -32000 old data not available due to pruning döndürür (faturalandırılmaz); pencere dışındaki bir işlem karmaya (hash) göre arandığında result: null döndürür.
• eth_getLogs: İstek başına maksimum blok aralığı, GET /v1/chains içindeki max_logs_block_range değeridir.

Data API

• Yalnızca yakın geçmiş verileri: Ethereum veri kapsamı, GET /v1/data/chains içindeki coverage.from_block ile belirlenir. Başlangıcın altındaki bir blok numarası veya pencere 422 no_coverage döndürür; pencereden çıkmış bir işlem karması 404 döndürür.
• from_block null olduğunda: Başlangıç geçici olarak bilinmemektedir. Bunu 0 veya tam geçmiş olarak kabul etmeyin ve yeniden bir tamsayı olana kadar Ethereum için geçmiş istekleri (blok numarası, pencere veya karma ile) göndermeyin; bunlar 503 unavailable döndürür.
• 503 gateway_overloaded: Üstel bekleme (backoff) ile yeniden deneyin (Retry-After: 1).
• Veri kümeleri: Ethereum'un sunduğu veri kümeleri GET /v1/data/chains yanıtının features alanında listelenir; diğerleri 422 no_coverage döndürür (faturalandırılmaz). Adres işlemleri ve transferleri yalnızca pencereyi kapsar: Başlangıcını kesen bir yanıt meta.coverage: "partial" olarak işaretlenir.

Zincirleri programatik olarak keşfetme

Desteklenen zincirleri ve durumlarını keşfetmek için bu genel uç noktaları kullanın:

1. Hizmet durumu (GET /v1/status)

API key gerektirmeyen genel bir uç nokta (CORS *). Yalnızca herkese açık zincirleri listeler ve bunların durumlarını ve indekslenmiş tepe bloklarını döndürür:

curl -s "https://api.blockvectra.com/v1/status"

Örnek yanıt:

{
  "checked_at": "2026-09-28T07:40:00Z",
  "gateway": { "status": "ok" },
  "chains": [
    {
      "chain": "robinhood_mainnet",
      "name": "Robinhood Chain",
      "chain_id": 4663,
      "jsonrpc": true,
      "data": true,
      "status": "ok",
      "data_status": "ok",
      "sync": { "stage": "synced", "node_block": 74600000, "target_block": null },
      "head": {
        "block": 74600000,
        "time": "2026-09-28T07:39:58Z",
        "lag_seconds": 3
      }
    },
    {
      "chain": "eth_mainnet",
      "name": "Ethereum",
      "chain_id": 1,
      "jsonrpc": true,
      "data": true,
      "status": "ok",
      "data_status": "ok",
      "sync": { "stage": "synced", "node_block": 26010000, "target_block": null },
      "head": {
        "block": 26010000,
        "time": "2026-09-28T07:39:59Z",
        "lag_seconds": 1
      }
    }
  ]
}

Her girdinin name alanı her zaman zincirin İngilizce görünen adıdır. jsonrpc ve data, o zincirin sırasıyla JSON-RPC ve Data API'ye açık olup olmadığını bildirir; status "ok" veya "unavailable" değeridir. Bir zincir senkronize oluyorsa, o zincire yapılan çağrılar -32010 döndürür. /v1/status üzerinde, status JSON-RPC'nin sağlıklı olup olmadığını ve data_status Data API'nin sağlıklı olup olmadığını bildirir ("ok", "syncing" veya "unavailable"); /v1/data/chains içinde, false olan bir coverage.has_data, zincirin henüz indekslenmiş verisi olmadığı anlamına gelir.

2. Data API zincirleri (GET /v1/data/chains)

x-api-key başlığında bir API key gerektirir (faturalandırılır). Data API'nin sunduğu genel zincirleri, her birinin sunduğu özellikleri (features), verilerinin kapsadığı blokları (coverage), düğümün konsensüs safe/finalized işaretçilerini ve durumlarını (finality) ve istek başına sınırlarını (limits) döndürür:

curl -s "https://api.blockvectra.com/v1/data/chains" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Örnek yanıt:

{
  "data": [
    {
      "chain": "robinhood_mainnet",
      "chain_slug": "ROBINHOOD_MAINNET",
      "name": "Robinhood Chain",
      "chain_id": 4663,
      "chain_external_id": "eip155:4663",
      "features": [
        "blocks", "transactions", "address_transactions", "transfers", "token_metadata",
        "balances", "holders", "nfts", "dex_swaps", "dex_prices", "stocks", "traces", "freshness"
      ],
      "coverage": { "from_block": 0, "traces_from_block": 1000000, "has_data": true },
      "finality": { "model": "node_tags", "status": "ok", "safe_block": 74599400, "finalized_block": 74598900 },
      "limits": { "max_page_size": 500, "max_window_blocks": 100000, "max_pools_for_token": 200, "max_batch_addresses": 100 }
    },
    {
      "chain": "eth_mainnet",
      "chain_slug": "ETH_MAINNET",
      "name": "Ethereum",
      "chain_id": 1,
      "chain_external_id": "eip155:1",
      "features": ["blocks", "transactions", "address_transactions", "transfers", "token_metadata", "freshness"],
      "coverage": { "from_block": 1000000, "traces_from_block": null, "has_data": true },
      "finality": { "model": "node_tags", "status": "stale", "safe_block": 26009950, "finalized_block": 26009900 },
      "limits": { "max_page_size": 500, "max_window_blocks": 100000, "max_pools_for_token": 200, "max_batch_addresses": 100 }
    }
  ]
}

finality, düğümün konsensüs işaretçilerini (model "node_tags" değerindedir), işaretçi sağlığını (status "ok", "stale" veya "unavailable" değerindedir) ve mevcut safe_block ile finalized_block değerlerini bildirir (safe_block >= finalized_block şeklindedir ve her ikisi de yalnızca durum "unavailable" olduğunda null olur).

coverage.from_block, canlı okunan en düşük indekslenmiş bloktur. Zincirin geçmişi başlangıç bloğuna (genesis) ulaştığında 0 olur. Yalnızca zincirin hiç indekslenmiş bloğu olmadığında (has_data = false) veya başlangıç belirlenemediğinde null olabilir: null değerini bilinmeyen olarak değerlendirin — tam geçmiş olarak değil ve 0 olarak değil — ve geçmiş istekleri bu durumda 503 unavailable döndürür. Bunu sabit kodlamak yerine çalışma zamanında her zaman bu uç noktadan okuyun. coverage.traces_from_block, izleme (trace) verilerine sahip ilk bloktur; ondan önceki veya bir boşluk içindeki bir trace isteği 422 no_coverage döndürür (faturalandırılmaz).

Bilinmeyen veya herkese açık olmayan bir zincirle /v1/data/{chain}/… çağırmak, error.code not_found ile HTTP 404 döndürür (faturalandırılmaz; zincir adı tam olarak küçük harfli slug olmalıdır).