Blockchain Data API

Zero-anti-bot blockchain data API. Wallet portfolios, whale alerts, cross-chain balances, and live token prices — no scraping, no CAPTCHAs, no ToS issues.

Quick Start

# Health check
curl https://imapp--blockchain-api.apify.actor/health
# {"status":"ok","service":"blockchain-api","version":"0.2.10"}

# Token price
curl https://imapp--blockchain-api.apify.actor/v1/token-price/ETH
# {"symbol":"ETH","price_usd":2987.45,"source":"coingecko"}

# Wallet portfolio
curl -X POST https://imapp--blockchain-api.apify.actor/v1/wallet \
  -H "Content-Type: application/json" \
  -d '{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

# Whale alerts
curl -X POST https://imapp--blockchain-api.apify.actor/v1/whale-alerts \
  -H "Content-Type: application/json" \
  -d '{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "eth_threshold": 50}'

# Cross-chain balances
curl -X POST https://imapp--blockchain-api.apify.actor/v1/cross-chain \
  -H "Content-Type: application/json" \
  -d '{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chains": ["eth","polygon","avax"]}'

API Reference

All data endpoints are versioned under /v1. The /health endpoint is unversioned.

GET /health

{"status":"ok","service":"blockchain-api","version":"0.2.10"}

POST /v1/trial

Get a free 7-day Pro trial API key (25 RPS, 100K calls/mo, all endpoints).

Limited to 1 key per IP address. Returns your existing key if you already have one. Rate-limited to 1 request per 60 seconds for new key generation.

$curl -X POST https://imapp--blockchain-api.apify.actor/v1/trial

{
  "api_key": "trial_a1b2c3d4e5f6g7h8",
  "tier": "pro",
  "expires_in_days": 7,
  "usage_instructions": {
    "authorization": "Bearer trial_a1b2c3d4e5f6g7h8",
    "endpoints": [
      "GET /v1/token-price/{symbol}",
      "POST /v1/wallet",
      "POST /v1/whale-alerts",
      "POST /v1/cross-chain"
    ],
    "docs": "/docs"
  }
}

GET /v1/token-price/{symbol}

Live USD price. Sources: CoinGecko → Chainlink → fallback.

Param	Description
symbol	ETH, MATIC, or AVAX (case-insensitive)

{"symbol":"ETH","price_usd":2987.45,"source":"coingecko"}

POST /v1/wallet

Field	Type	Default	Description
address	string	required	0x-prefixed address
include_tokens	bool	true	ERC-20 token balances
include_nfts	bool	false	NFT holdings
include_transfers	bool	false	Recent transfers
transfer_limit	int	20	Max transfers (1–100)
chain	string	"eth"	Chain key

POST /v1/whale-alerts

Field	Type	Default	Description
address	string	required	Address to monitor
eth_threshold	float	50	ETH alert threshold
usd_threshold	float	100000	USD alert threshold
direction	string	"both"	"in", "out", or "both"
lookback_blocks	int	1000	Blocks to scan (~4 hours)

POST /v1/cross-chain

Field	Type	Default	Description
address	string	required	Address
chains	list	all	eth, arb, base, polygon, opt, avax
include_tokens	bool	true	Include token counts
include_nfts	bool	false	Include NFT counts

Supported Chains

Key	Chain	Currency
eth	Ethereum	ETH
arb	Arbitrum	ETH
base	Base	ETH
polygon	Polygon	MATIC
opt	Optimism	ETH
avax	Avalanche C-Chain	AVAX

Pricing

Pay per result — you only pay for what you use.

Event	Price	Note
API result	$0.0004	Charged per API response. 10K calls = $4, 100K = $40, 500K = $200.
Actor start	$0.00005	One-time fee per session (first 5s waived).

Apify user tier	Your price per result
Free	$0.0004
Bronze	$0.0003
Silver	$0.00025
Gold	$0.0002

Higher Apify tiers get automatic volume discounts — no coupon codes, no hidden fees.

Tier limits (enforced server-side)

Tier	Calls/mo	RPS	Chains
Free	3,000	2	1
Starter	10,000	5	3
Pro	100,000	25	6
Enterprise	500,000	50	6

At $0.0004/result, 10K calls cost just $4 — 60% less than GoldRush ($10/mo minimum). Pro at 100K calls ($40) undercuts QuickNode ($49/mo) and Infura ($50/mo). Enterprise at 500K calls ($200) competes with Moralis ($199/mo) on volume while offering dedicated rate limits (50 RPS) and 6 chains.

New users get a free 7-day Pro trial (25 RPS, 100K calls/mo, all endpoints) by calling POST /v1/trial. No credit card required.

Authentication

Pass your API key via x-api-key or Authorization: Bearer header:

curl https://imapp--blockchain-api.apify.actor/v1/token-price/ETH \
  -H "x-api-key: sk_starter_abc123"

No key? You get the free tier automatically.

Rate Limits

Each tier has a requests-per-second cap and a monthly quota. Exceed either and you get 429 Too Many Requests with Retry-After.

Every response includes rate-limit headers:

X-RateLimit-Limit-RPS: 5
X-RateLimit-Remaining-RPS: 4
X-RateLimit-Limit-Monthly: 10000
X-RateLimit-Remaining-Monthly: 9997
X-Tier: free

When rate-limited:

{"detail":"RPS limit exceeded","retry_after_seconds":0.85}

Errors

Status	Code	Meaning
400	invalid_chain / unknown_token	Bad parameter
422	validation	Invalid address format
429	rate_limited	RPS or monthly quota exceeded
502	rpc_error / price_unavailable	Upstream failure

License

MIT