API Documentation
Public REST API for the Verus blockchain explorer. No authentication required.
https://scan.verus.cx Chains: VRSC, vARRR, vDEX, CHIPS Rate: 100 req/min LLM/curl: curl scan.verus.cx/api/TVL
$27.20M
30d Volume
$3.60M
Identities
41,398
Currencies
43
Baskets
19
Chains
4
Access Tiers
Rate limits use a weighted credit system. Light endpoints (cached) cost 1 credit, DB queries cost 2, RPC-backed cost 5.
10 credits/min
- All explorer endpoints (blocks, tx, addresses, identities)
- Market data, oracle prices, volume, baskets
- Network stats, search
- No conversion estimates (RPC-backed)
60 credits/min
- All endpoints including conversion estimates
- Usage tracking and dashboard
- = 60 cached reads, or 30 DB queries, or 12 RPC calls per minute
Get a free API key
# Register
curl -X POST https://scan.verus.cx/api/auth/register \
-H "Content-Type: application/json" \
-d '{\"email\":\"you@example.com\", \"label\":\"my app\"}'
# Use it
curl -H "X-API-Key: sv_live_..." https://scan.verus.cx/api/market/estimate?from=VRSC&to=tBTC.vETH&amount=100
# Check usage
curl -H "X-API-Key: sv_live_..." https://scan.verus.cx/api/auth/usage
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Tier headers.
Endpoint weights
market/protocol, currencies, baskets, volume, vrsc-pools, oracle/prices, stats, search, health
blocks, tx, address history, identity, conversions, bridge, richlist, stakes, pairs, reserve history
address/balance (RPC), market/estimate, market/best-conversion, /raw endpoints
Market Data & DeFi
Prices, baskets, volume, liquidity — powered by the oracle and conversion database.
/api/market/protocol Protocol summary: TVL, identities, currencies, baskets, chains, VRSC in pools, volume, trades, fees
/api/market/overview Dashboard data with top movers, top baskets, and volume history
/api/market/currencies All priced currencies with price, 24h change, volume, liquidity, sparkline
/api/market/pairs All trading pairs with price, OHLC, volume, liquidity
/api/market/baskets All active baskets sorted by TVL with full reserve breakdown
/api/market/baskets/:id/reserves?days=7 Reserve balance time series (up to 200 data points)
/api/market/baskets/:id/volume?days=30 Daily volume and fees through a specific basket
/api/market/volume 30-day daily volume chart with trade counts and fees
/api/market/vrsc-pools VRSC distribution across all baskets with USD values
/api/market/estimate?from=VRSC&to=tBTC.vETH&amount=100 Estimate conversion output (RPC-backed)
/api/market/best-conversion?from=VRSC&to=tBTC.vETH&amount=100 Compare rates across all eligible baskets
/api/oracle/prices All oracle-priced currencies with confidence and depth
/api/oracle/prices/:id Single currency price with per-basket breakdown
/api/oracle/prices/:id/history?hours=24 Price history snapshots
Explorer
Block, transaction, address, identity, and currency data. Compatible with existing Verus explorer APIs.
/api/blocks/?chain=vrsc&page=1&pageSize=25 Paginated block list
/api/blocks/:height?chain=vrsc Block detail by height
/api/blocks/:height/raw?chain=vrsc Raw block with decoded transactions
/api/tx/:txid?chain=vrsc Transaction detail
/api/tx/:txid/raw?chain=vrsc Raw transaction (RPC-compatible format)
/api/address/:addr?chain=vrsc Address transaction history
/api/address/:addr/balance Address balance
/api/address/:addr/rewards Mining and staking rewards
/api/address/:addr/conversions DeFi conversions with full filter support
/api/identity/ Paginated identity list
/api/identity/stats Identity counts per chain
/api/identity/:nameOrId Identity detail by name or i-address
/api/identity/:nameOrId/referrals Sub-ID referral tree (3 levels)
/api/currency/:nameOrId Currency definition detail
/api/conversions/ Conversion list with USD values and filters
/api/conversions/filters Available filter options
/api/bridge/recent VRSC-ETH bridge transfers
/api/richlist/top?limit=100 Top VRSC holders
/api/richlist/tokens All tokens with holder counts
/api/stakes/ Staking transactions
/api/search/?q=query Universal search
Network Stats
Chain sync status, mining stats, charts, and service health.
/api/stats/ Sync height and transaction count
/api/stats/network Hashrate, difficulty, PoS/PoW ratio, block time
/api/stats/charts?metric=difficulty&period=30d Chart data for difficulty, transactions, conversions
/api/stats/pulse Live block feed across all chains
/api/stats/status Service health and indexer state
/api/health Health check
JSON-RPC
Wire-compatible with api.verus.services. Drop-in replacement for wallets and dApps. 66 whitelisted read-only methods.
/ JSON-RPC 1.0/2.0 for VRSC (wire-compatible with api.verus.services)
/rpc/:chain JSON-RPC for PBaaS chains (varrr, vdex, chips)
/api/ws WebSocket: real-time block notifications
USD Pricing Methodology
How USD values are derived for all conversions, prices, and volume data.
Price Derivation (tiered, in priority order)
Key Design Decisions
priceinreserve is used instead of raw reserve ratios — it correctly handles unequal basket weights (e.g. Floralis has VRSC at 20%, scrvUSD at 5%).
Per-trade stamping — each conversion is stamped with USD at the exact block height, not hourly or daily averages.
UTC day boundaries ��� all volume, trade counts, and fees use midnight-to-midnight UTC for CMC/CoinGecko compatibility.
Validation — every price is cross-checked: if from_usd and to_usd disagree by more than 10%, the stablecoin-derived side is preferred.
Oracle accuracy — reserve-derived pricing gives ~0.3% error vs trade execution pricing (~2%+ error from AMM slippage).
Coverage
2.2M+ conversions stamped with USD values across 4 chains. 100% coverage.
Oracle prices update every 60 seconds from on-chain basket reserves.
Reserve state snapshots every 5 minutes for historical trend analysis.