Solscan APIsolscan.io ↗
Access Solana network stats, transactions, blocks, tokens, DeFi metrics, whale tracking, and MEV activity via the Solscan.io API. 23 endpoints.
What is the Solscan API?
The Solscan.io API covers 23 endpoints for Solana blockchain data, from network-level snapshots to token holder lists and MEV sandwich attack records. get_network_stats returns epoch info, TPS by timeframe, validator count, and SOL supply in a single call. Other endpoints cover DeFi pool metrics across Raydium, Orca, and Meteora; real-time whale transfers with USD values; and per-account balance change history — all returning structured JSON.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/030ae54a-ee02-419a-86a7-d3b18be05c6f/get_network_stats' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace solscan-io-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Solscan.io API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.solscan_io_api import (
Solscan,
TokenSortBy,
Sort,
NetworkAnalyticsFilter,
NotFoundError,
)
# Initialize client
solscan = Solscan()
# Get top tokens by market cap - bounded iteration
for token in solscan.tokens.leaderboard(sort_by=TokenSortBy.MARKET_CAP, sort_order=Sort.DESC, limit=3):
print(token.address, token.market_cap, token.price, token.holder)
# Track whale transfers - take one and inspect
whale = solscan.whaletransfers.list(limit=1).first()
if whale:
print(whale.trans_id, whale.from_address, whale.to_address, whale.value)
# Get DeFi platform metrics using constructible resource
raydium = solscan.defiplatform("raydium")
for metric in raydium.dashboard(limit=3):
print(metric.date, metric.total_tvl, metric.total_vol, metric.num_trading)
# Account sub-resources: list token holdings for an address
acct = solscan.account("9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM")
for tok in acct.token_accounts.list(limit=3):
print(tok.token_name, tok.token_symbol, tok.balance)
# Typed error handling around a point lookup
try:
detail = solscan.tokens.get(token_address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
print(detail.token_name, detail.token_symbol, detail.price_usdt)
except NotFoundError as exc:
print(f"Token not found: {exc}")
# Network analytics with enum filter
stats = solscan.analyticsresults.network(filter=NetworkAnalyticsFilter.BLOCKS)
print(stats.days)
print("exercised: tokens.leaderboard / whaletransfers.list / defiplatform.dashboard / account.token_accounts.list / tokens.get / analyticsresults.network")
Get real-time Solana network stats including epoch info, TPS, validator count, SOL supply, and stake overview. Returns a snapshot of the current network state.
No input parameters required.
{
"type": "object",
"fields": {
"data": "object containing blockHeight, currentEpoch, epochInfo, networkInfo, solStakeOverview, solSupply, tpsByTimeframe",
"success": "boolean indicating API success"
},
"sample": {
"data": {
"epochInfo": {
"epoch": 984,
"slotIndex": 407753,
"slotsInEpoch": 432000
},
"solSupply": {
"total": 628044891.12,
"circulating": 579389318.69
},
"blockHeight": 403577026,
"networkInfo": {
"tps": 2744.27,
"totalValidators": 744
},
"absoluteSlot": 425495753,
"currentEpoch": 984
},
"success": true
}
}About the Solscan API
Network, Block, and Transaction Data
get_network_stats returns blockHeight, currentEpoch, epochInfo, tpsByTimeframe, solSupply, and solStakeOverview with no required parameters, making it a quick health check for the Solana network. get_block_list accepts a limit of either 8 or 400 and returns each block's slot, blockhash, validator, fee_rewards, and transaction count. get_transaction_detail takes a base58 tx_signature and returns parsed instructions (pars), sol_bal_change, token_bal_change, fee, and status — giving a full picture of what a transaction did.
Account and Token Endpoints
get_account_transactions, get_account_token_accounts, get_account_defi_activities, and get_account_balance_changes all accept a base58 address with optional page and page_size parameters. Balance change records include block_id, block_time, amount, change_type, and associated token info. get_token_detail returns token_name, token_symbol, token_decimals, price_usdt, and a reputation field for a given mint address. get_token_holders pages through ranked holders with amount, decimals, and owner fields. get_token_leaderboard sorts tokens by market_cap, holder, price, or price_24h_change and includes tvl per token.
DeFi Platform Metrics
Three endpoints target DeFi platforms by app_id (known values: raydium, orca, meteora). get_defi_dashboard returns daily time-series objects with total_tvl, total_vol, and num_trading, broken down by platform program IDs over a configurable time_range in days. get_defi_markets lists pool pairs with total_trades_24h, total_volume_24h, and total_tvl. get_defi_activities streams swap events with activity_type, amount_info, and USD value.
Whale Tracking and MEV Monitoring
get_whale_tracking returns large-transfer records including from_address, to_address, value in USD, amount, and the source program — paginated via page and page_size. get_mev_activity exposes sandwich attack data: attacker, victim, the buy and sell transaction IDs (attack_txs_buy, attack_txs_sell), attack_delta_value, and the token pair involved. get_leaderboard_programs ranks Solana programs by number_transactions, success_rate, and active_users over a configurable range in days.
The Solscan API is a managed, monitored endpoint for solscan.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when solscan.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official solscan.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Solana network dashboard displaying live TPS, epoch progress, and stake overview from
get_network_stats. - Track token distribution by paging through
get_token_holdersto identify wallet concentration for a given mint. - Monitor DeFi liquidity shifts on Raydium or Orca using daily TVL and volume time-series from
get_defi_dashboard. - Alert on large on-chain transfers by polling
get_whale_trackingfor transfers exceeding a USD value threshold. - Audit MEV exposure by querying
get_mev_activityto surface sandwich attack profit deltas and victim addresses. - Profile a wallet's full on-chain history by combining
get_account_transactions,get_account_balance_changes, andget_account_defi_activities. - Rank Solana programs by adoption and reliability using
get_leaderboard_programswithsuccess_rateandactive_users.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Solscan have an official developer API?+
What does `get_block_list` return, and are there constraints on the `limit` parameter?+
blockHeight, blockTime, blockhash, validator, fee_rewards, and transaction count. The limit parameter only accepts the values 8 or 400; other values are not supported by the upstream source.Does the API support filtering whale transfers by a minimum USD value or token type?+
get_whale_tracking currently returns all large transfers paginated by page and page_size without server-side filtering by value or token. You can fork this API on Parse and revise it to add filtering logic for value or token address in the endpoint's response handling.Are NFT transactions or NFT collection data covered?+
How fresh is the transaction and block data returned?+
get_transaction_list and get_block_list reflect recently confirmed on-chain state, but there is no explicit timestamp on API freshness. For time-sensitive use cases, treat the data as near-real-time rather than guaranteed sub-second; get_network_stats includes a blockHeight you can use to detect staleness.