Solscan Pro Skill

Empowers AI agents to retrieve professional-grade Solana on-chain data across accounts, tokens, NFTs, transactions, blocks, markets, and programs.

When to Use This Skill

User asks about a Solana wallet address, balance, portfolio, or stake
User wants token price, holders, markets, or trending tokens
User needs to inspect a transaction signature or decode instructions
User asks about NFT collections, items, or recent NFT activity
User wants DeFi activity, transfer history, or reward exports
User wants to analyze a program's on-chain statistics, transaction metrics, or user activity
User needs to check popular DeFi platforms or view API usage

Authentication

All requests require an API key in the HTTP header:

token: <YOUR_SOLSCAN_API_KEY>

Base URL: https://pro-api.solscan.io/v2.0

Tools

Tool 1 — Direct API CLI (Precise Data)

Use when: you need exact, structured on-chain data for a specific address, signature, block, or mint.

Syntax: python3 scripts/solscan.py <resource> <action> [--param value]

Tool 2 — MCP Natural Language Tools

Use when: answering general exploratory questions or when the user does not provide a specific address.

Available MCP tools:

search_transaction_by_signature — look up a transaction by its signature
get_account_balance — retrieve SOL balance for a wallet
get_token_metadata — get name, symbol, decimals for a token mint

API Reference

Account

| Action | Key Params | Returns | |---|---|---| | account detail | --address | Lamports, owner, executable flag | | account data-decoded | --address | Decoded account data | | account metadata | --address | Label, icon, tags, domain, funder | | account metadata-multi | --addresses | Batch metadata (comma-separated) | | account transfer | --address [filters...] | SPL + SOL transfer history (supports activity-type, token, flow, time range filters) | | account defi | --address [filters...] | DeFi protocol interactions (activity-type, from, platform, source, token, time range) | | account balance-change | --address [filters...] | Historical balance changes (token, flow, amount, time range, remove-spam) | | account transactions | --address [--before] [--limit] | Recent transactions list (cursor-based pagination) | | account portfolio | --address [--exclude-low-score-tokens] | Token holdings with USD value | | account tokens | --address --type [--page] [--page-size] [--hide-zero] | Associated token/NFT accounts (page-size: 10/20/30/40) | | account stake | --address [--page] [--page-size] [--sort-by] [--sort-order] | Active stake accounts (page-size: 10/20/30/40) | | account reward-export | --address [--time-from] [--time-to] | Staking reward history CSV (max 5000 items, max 1 req/min) | | account transfer-export | --address [filters...] | Transfer history CSV (max 5000 items, max 1 req/min) | | account leaderboard | [--sort-by] [--sort-order] [--page] [--page-size] | Top accounts by activity | | account defi-export | --address [filters...] | DeFi activity CSV (max 5000 items, max 1 req/min) |

account metadata response fields:

account_address, account_label, account_icon, account_tags, account_type, account_domain, funded_by, tx_hash, block_time

account transfer filter options:

--activity-type: Transfer type filter (comma-separated). Options: ACTIVITY_SPL_TRANSFER, ACTIVITY_SPL_BURN, ACTIVITY_SPL_MINT, ACTIVITY_SPL_CREATE_ACCOUNT, ACTIVITY_SPL_CLOSE_ACCOUNT, ACTIVITY_SPL_TOKEN_WITHDRAW_STAKE, ACTIVITY_SPL_TOKEN_SPLIT_STAKE, ACTIVITY_SPL_TOKEN_MERGE_STAKE, ACTIVITY_SPL_VOTE_WITHDRAW, ACTIVITY_SPL_SET_OWNER_AUTHORITY

--token-account: Filter transfers for a specific token account in the wallet

--from: Filter by source address(es) (max 5, comma-separated)

--exclude-from: Exclude transfers from address(es) (max 5, comma-separated)

--to: Filter by recipient address(es) (max 5, comma-separated)

--exclude-to: Exclude transfers to address(es) (max 5, comma-separated)

--token: Filter by token address(es) (max 5, comma-separated). Use So11111111111111111111111111111111111111111 for native SOL

--amount: Amount range filter (min max)

--value: USD value range filter (min max)

--from-time, --to-time: Unix timestamp range filter

--exclude-amount-zero: Exclude transfers with zero amount (boolean)

--flow: Transfer direction: in|out

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

--sort-order: Sort order: asc|desc (default: desc)

Deprecated parameters: sort_by, block_time (use from_time/to_time instead)

account defi filter options:

--activity-type: Activity type filter (comma-separated). Options: ACTIVITY_TOKEN_SWAP, ACTIVITY_AGG_TOKEN_SWAP, ACTIVITY_TOKEN_ADD_LIQ, ACTIVITY_TOKEN_REMOVE_LIQ, ACTIVITY_POOL_CREATE, ACTIVITY_SPL_TOKEN_STAKE, ACTIVITY_LST_STAKE, ACTIVITY_SPL_TOKEN_UNSTAKE, ACTIVITY_LST_UNSTAKE, ACTIVITY_TOKEN_DEPOSIT_VAULT, ACTIVITY_TOKEN_WITHDRAW_VAULT, ACTIVITY_SPL_INIT_MINT, ACTIVITY_ORDERBOOK_ORDER_PLACE, ACTIVITY_BORROWING, ACTIVITY_REPAY_BORROWING, ACTIVITY_LIQUIDATE_BORROWING, ACTIVITY_BRIDGE_ORDER_IN, ACTIVITY_BRIDGE_ORDER_OUT

--from: Filter activities from a specific address

--platform: Filter by platform address(es) (comma-separated, max 5)

--source: Filter by source address(es) (comma-separated, max 5)

--token: Filter by token address

--from-time, --to-time: Unix timestamp range filter

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

--sort-by: Sort field (default: block_time, options: block_time)

--sort-order: Sort order: asc|desc (default: desc)

Deprecated parameters: block_time (use from_time/to_time instead)

account balance-change filter options:

--token-account: Filter by specific token account

--token: Filter by token address

--amount: Amount range (min max)

--flow: in|out

--remove-spam: true|false

--from-time, --to-time: Unix timestamp range

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

--sort-by: Sort field (default: block_time, options: block_time)

--sort-order: Sort order: asc|desc (default: desc)

Deprecated parameters: block_time (use from_time/to_time instead)

account transactions pagination:

Uses cursor-based pagination with --before (transaction signature)

--limit: 10, 20, 30, 40 (default: 10)

No page/page_size parameters

account stake options:

--sort-by: active_stake|delegated_stake (default: active_stake)

--sort-order: asc|desc

--page-size: 10, 20, 30, 40 (default: 10)

account reward-export parameters:

--time-from: Start time (Unix timestamp in seconds, default: 1 month before time-to)

--time-to: End time (Unix timestamp in seconds, default: current time)

account transfer-export filter options:

--activity-type: Transfer type filter (comma-separated). Options: ACTIVITY_SPL_TRANSFER, ACTIVITY_SPL_BURN, ACTIVITY_SPL_MINT, ACTIVITY_SPL_CREATE_ACCOUNT, ACTIVITY_SPL_CLOSE_ACCOUNT, ACTIVITY_SPL_TOKEN_WITHDRAW_STAKE, ACTIVITY_SPL_TOKEN_SPLIT_STAKE, ACTIVITY_SPL_TOKEN_MERGE_STAKE, ACTIVITY_SPL_VOTE_WITHDRAW, ACTIVITY_SPL_SET_OWNER_AUTHORITY

--token-account: Filter by specific token account address

--from: Filter from address

--to: Filter to address

--token: Filter by token address (use So11111111111111111111111111111111111111111 for native SOL)

--amount: Amount range (min max)

--from-time, --to-time: Unix timestamp range

--exclude-amount-zero: Exclude zero amount transfers

--flow: Transfer direction: in|out

Deprecated parameters: block_time (use from_time/to_time instead)

account leaderboard options:

--sort-by: sol_values|stake_values|token_values|total_values (default: total_values)

--sort-order: asc|desc

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

account defi-export filter options:

--activity-type: Activity type filter (comma-separated). Options: ACTIVITY_TOKEN_SWAP, ACTIVITY_AGG_TOKEN_SWAP, ACTIVITY_TOKEN_ADD_LIQ, ACTIVITY_TOKEN_REMOVE_LIQ, ACTIVITY_POOL_CREATE, ACTIVITY_SPL_TOKEN_STAKE, ACTIVITY_LST_STAKE, ACTIVITY_SPL_TOKEN_UNSTAKE, ACTIVITY_LST_UNSTAKE, ACTIVITY_TOKEN_DEPOSIT_VAULT, ACTIVITY_TOKEN_WITHDRAW_VAULT, ACTIVITY_SPL_INIT_MINT, ACTIVITY_ORDERBOOK_ORDER_PLACE, ACTIVITY_BORROWING, ACTIVITY_REPAY_BORROWING, ACTIVITY_LIQUIDATE_BORROWING, ACTIVITY_BRIDGE_ORDER_IN, ACTIVITY_BRIDGE_ORDER_OUT

--from: Filter activities from a specific address

--platform: Filter by platform address(es) (comma-separated, max 5)

--source: Filter by source address(es) (comma-separated, max 5)

--token: Filter by token address

--from-time, --to-time: Unix timestamp range

--sort-by: Sort field (default: block_time, options: block_time)

--sort-order: Sort order: asc|desc (default: desc)

Deprecated parameters: block_time (use from_time/to_time instead)

Token

| Action | Key Params | Returns | |---|---|---| | token meta | --address | Name, symbol, decimals, supply | | token meta-multi | --addresses | Batch metadata | | token price ⚠️ | --address [--from-time] [--to-time] | DEPRECATED - Single token price history (use token price-history instead) | | token price-multi ⚠️ | --addresses [--from-time] [--to-time] | DEPRECATED - Batch price history (use token price-history instead) | | token price-latest | --addresses | Latest price of multiple tokens (max 50, comma-separated) | | token price-history | --addresses [--from-time] [--to-time] | Historical price of multiple tokens (max 50, comma-separated; time: YYYYMMDD) | | token holders | --address [--page] [--page-size] [--from-amount] [--to-amount] | Top holder list with amounts (page-size: 10/20/30/40) | | token markets | --token [--sort-by] [--program] [--page] [--page-size] | DEX markets: 1 token for all markets, 2 tokens for pair search | | token transfers | --address [filters...] | Transfer history | | token defi | --address [filters...] | DeFi activity | | token defi-export | --address [filters...] | DeFi activity CSV | | token historical | --address [--range] | Historical data (price, volume, holder, trader,...) for a token (range: 7 or 30 days, default: 7) | | token search | --keyword [--search-mode] [--search-by] [--sort-by] [--sort-order] [--page] [--page-size] | Search tokens by keyword/address/name/symbol | | token trending | [--limit] | Currently trending tokens | | token list | [--page] [--page-size] [--sort-by] [--sort-order] | Full token list (sort: holder|market_cap|created_time) | | token top | — | Top tokens by market cap | | token latest | [--platform-id] [--page] [--page-size] | Newly listed tokens (page-size: 10/20/30/40/60/100) |

token price parameters ⚠️ DEPRECATED:

--address: Token address (required)

--from-time: Start time in YYYYMMDD format (optional)

--to-time: End time in YYYYMMDD format (optional)

token price-multi parameters ⚠️ DEPRECATED:

--addresses: Token addresses, comma-separated (max 50, required)

--from-time: Start time in YYYYMMDD format (optional)

--to-time: End time in YYYYMMDD format (optional)

token price-latest parameters:

--addresses: Token addresses, comma-separated (max 50, required)

token price-history parameters:

--addresses: Token addresses, comma-separated (max 50, required)

--from-time: Start time in YYYYMMDD format (optional)

--to-time: End time in YYYYMMDD format (optional)

token holders parameters:

--address: Token address (required)

--from-amount: Minimum token holding amount (string format, optional)

--to-amount: Maximum token holding amount (string format, optional)

--page: Page number (default: 1)

--page-size: 10, 20, 30, 40 (default: 10)

token markets parameters:

--token: Token address(es) - REQUIRED (1 token for all markets, 2 tokens for pair search, comma-separated)

--sort-by: Sort field: volume|trade|tvl|trader

--program: Filter by DEX program(s) (comma-separated, max 5)

--page: Page number (default: 1)

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

token transfers filter options:

--activity-type: Transfer type filter (comma-separated). Options: ACTIVITY_SPL_TRANSFER, ACTIVITY_SPL_BURN, ACTIVITY_SPL_MINT, ACTIVITY_SPL_CREATE_ACCOUNT, ACTIVITY_SPL_CLOSE_ACCOUNT, etc.

--from: Filter from address(es) (max 5, comma-separated)

--exclude-from: Exclude from address(es) (max 5, comma-separated)

--to: Filter to address(es) (max 5, comma-separated)

--exclude-to: Exclude to address(es) (max 5, comma-separated)

--amount: Amount range (min max)

--value: USD value range (min max)

--exclude-amount-zero: Exclude zero amount transfers (boolean flag)

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

--sort-by: block_time (default: block_time)

--sort-order: asc|desc (default: desc)

token defi filter options:

--activity-type: Activity type filter (comma-separated). Options: ACTIVITY_TOKEN_SWAP, ACTIVITY_AGG_TOKEN_SWAP, ACTIVITY_TOKEN_ADD_LIQ, ACTIVITY_TOKEN_REMOVE_LIQ, ACTIVITY_POOL_CREATE, etc.

--from: Filter activities from a specific address

--platform: Filter by platform address(es) (comma-separated, max 5)

--source: Filter by source address(es) (comma-separated, max 5)

--token: Filter by token address

--from-time, --to-time: Unix timestamp range filter

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

--sort-by: block_time (default: block_time)

--sort-order: asc|desc (default: desc)

token defi-export filter options:

--activity-type: Activity type filter (comma-separated): ACTIVITY_TOKEN_SWAP, ACTIVITY_AGG_TOKEN_SWAP, etc.

--from: Filter activities from a specific address

--platform: Filter by platform address(es) (comma-separated, max 5)

--source: Filter by source address(es) (comma-separated, max 5)

--token: Filter by token address

--from-time, --to-time: Unix timestamp range filter

--sort-by: block_time (default: block_time)

--sort-order: asc|desc (default: desc)

token historical parameters:

--address: Token address (required)

--range: 7 or 30 days (default: 7)

token search parameters:

--keyword: Search term (required)

--search-by: combination|address|name|symbol (default: combination)

--search-mode: exact|fuzzy (default: exact)

--exclude-unverified-token: Exclude unverified tokens (boolean flag)

--sort-by: reputation|market_cap|volume_24h (default: reputation)

--sort-order: asc|desc (default: desc)

--page, --page-size: 10, 20, 30, 40 (default: 10)

token latest platforms:

--platform-id: jupiter, lifinity, meteora, orca, raydium, phoenix, sanctum, kamino, pumpfun, openbook, apepro, stabble, jupiterdca, jupiter_limit_order, solfi, zerofi, letsbonkfun_launchpad, raydium_launchlab, believe_launchpad, moonshot_launchpad, jup_studio_launchpad, bags_launchpad

Transaction

| Action | Key Params | Returns | |---|---|---| | transaction detail | --tx | Full tx details (token and sol balance changes, IDL data, defi or transfer activities of each instructions) | | transaction detail-multi | --txs | Batch tx details (max 50 transactions) | | transaction last | [--limit] [--filter] | Most recent transactions | | transaction actions | --tx | Human-readable decoded actions (transfers, swap activities, nft activities...) | | transaction actions-multi | --txs | Batch decoded actions (max 50 transactions) | | transaction fees | — | Network fees statistics (no parameters) |

transaction last parameters:

--limit: Number of transactions to return (10, 20, 30, 40, 60, 100, default: 10)

--filter: Filter type (exceptVote, all, default: exceptVote)

transaction detail parameters:

--tx: Transaction signature (required, length: 30-100 characters)

transaction detail-multi parameters:

--txs: Transaction signatures, comma-separated (required, max 50, each 30-100 characters)

transaction actions parameters:

--tx: Transaction signature (required, length: 30-100 characters)

transaction actions-multi parameters:

--txs: Transaction signatures, comma-separated (required, max 50, each 30-100 characters)

NFT

| Action | Key Params | Returns | |---|---|---| | nft news | --filter [--page] [--page-size] | Latest NFT activity feed (filter: created_time, page-size: 12/24/36) | | nft activities | [filters...] | NFT activities (all filters optional: from, to, source, activity-type, token, collection, currency-token, price, from-time, to-time) | | nft collections | [--range] [--sort-by] [--sort-order] [--collection] [--page] [--page-size] | Top NFT collections (range: 1/7/30 days, sort: items/floor_price/volumes) | | nft items | --collection [--sort-by] [--page] [--page-size] | Items inside a collection (sort: last_trade/listing_price, page-size: 12/24/36) |

nft activities parameters (all optional):

--from, --to: Filter by address

--source: Filter by source address(es) (comma-separated, max 5)

--activity-type: Type of activity (comma-separated). Options: ACTIVITY_NFT_SOLD, ACTIVITY_NFT_LISTING, ACTIVITY_NFT_BIDDING, ACTIVITY_NFT_CANCEL_BID, ACTIVITY_NFT_CANCEL_LIST, ACTIVITY_NFT_REJECT_BID, ACTIVITY_NFT_UPDATE_PRICE, ACTIVITY_NFT_LIST_AUCTION

--token: Token address

--collection: Collection address

--currency-token: Currency token address

--price: Price range filter (min max, requires currency_token parameter)

--from-time, --to-time: Unix timestamp range

--page-size: 10, 20, 30, 40, 60, 100 (default: 10)

--block-time ⚠️ DEPRECATED: Use --from-time/--to-time instead

nft collections parameters (all optional):

--range: Days range (1, 7, 30, default: 1)

--sort-by: Sort field (items, floor_price, volumes, default: volumes)

--sort-order: Sort order (asc, desc, default: desc)

--collection: Filter by collection ID

--page: Page number (default: 1)

--page-size: 10, 20, 30, 40 (default: 10)

nft items parameters:

--collection: Collection address (required)

--sort-by: Sort field (last_trade, listing_price, default: last_trade)

--page: Page number (default: 1)

--page-size: 12, 24, 36 (default: 12)

Block

| Action | Key Params | Returns | |---|---|---| | block last | [--limit] | Get the list of the latest blocks | | block detail | --block | Get the details of a block | | block transactions | --block [--page] [--page-size] [--exclude-vote] [--program] | Get the list of transactions of a block |

block last parameters:

--limit: Number of blocks to return (10, 20, 30, 40, 60, 100, default: 10)

block detail parameters:

--block: The slot index of a block (required, minimum: 0)

block transactions parameters:

--block: The slot index of a block (required, minimum: 0)

--page: Page number for pagination (default: 1)

--page-size: Number of items per page (10, 20, 30, 40, 60, 100, default: 10)

--exclude-vote: Excludes vote transactions from the results (boolean flag, default: false)

--program: The program used to filter transactions that interact with it (optional, string)

Market

| Action | Key Params | Returns | |---|---|---| | market list | [--page] [--page-size] [--program] [--token-address] [--sort-by] [--sort-order] | All trading pools/markets (sort: created_time|volumes_24h|trades_24h) | | market info | --address | Get market/pool details by address | | market volume | --address [--time] | Get historical market data and volume |

market list parameters:

--page: Page number (default: 1)

--page-size: Number of items per page (10, 20, 30, 40, 60, 100, default: 10)

--program: Program owner address (optional)

--token-address: Token address involved in market (optional)

--sort-by: Sort field (created_time, volumes_24h, trades_24h, default: volumes_24h)

--sort-order: Sort order (asc, desc, default: desc)

market info parameters:

--address: Market ID/address (required, minimum length: 30 characters)

market volume parameters:

--address: Market ID/address (required, minimum length: 30 characters)

--time: Filter data by time range in YYYYMMDD format. Pass start and end date to filter by time range (e.g., --time 20240701 20240715). Accepts 1-2 values (optional)

Program

| Action | Key Params | Returns | |---|---|---| | program list | [--sort-by] [--sort-order] [--page] [--page-size] | Programs active in last 90 days (sort: num_txs|num_txs_success|interaction_volume|success_rate|active_users_24h) | | program popular-platforms | — | Popular DeFi platforms | | program analytics | --address --range | Program-level analytics for any Solana program (range: 7 or 30 days, required) |

program list parameters:

--sort-by: Sort field (num_txs, num_txs_success, interaction_volume, success_rate, active_users_24h, default: num_txs)

--sort-order: Sort order (asc, desc)

--page: Page number (default: 1)

--page-size: 10, 20, 30, 40 (default: 10)

program analytics parameters:

--address: Program address on Solana blockchain (required, minimum: 30 characters)

--range: Analytics time range in days (7 or 30, required)

Monitor

| Action | Key Params | Returns | |---|---|---| | monitor usage | — | Your API key usage & rate limits |

Error Handling

| HTTP Code | Meaning | Agent Action | |---|---|---| | 400 | Bad request / invalid address | Validate address format, retry | | 401 | Authentication failed | Check token header is set correctly | | 429 | Rate limit exceeded | Wait and retry with backoff | | 500 | Internal server error | Retry once; report if persistent |

All error responses include success: false, code, and message fields.

Example Workflows

Wallet Research Workflow

[ ] Step 1: account metadata --address <ADDR> → confirm label and type
[ ] Step 2: account portfolio --address <ADDR> → get token holdings
[ ] Step 3: account transfer --address <ADDR> → review recent activity
[ ] Step 4: account defi --address <ADDR> → check protocol interactions

Token Analysis Workflow

[ ] Step 1: token meta --address <MINT> → confirm token identity
[ ] Step 2: token price --address <MINT> → get current price
[ ] Step 3: token holders --address <MINT> → check concentration risk
[ ] Step 4: token markets --token <MINT> → find best liquidity pools

Evaluations

| Query | Expected Behavior | |---|---| | "What tokens does wallet ABC123 hold?" | Calls account portfolio --address ABC123, returns token list with USD values | | "What is the current price of BONK?" | Calls token meta to resolve mint, then token price, returns USD price | | "Decode transaction XYZ..." | Calls transaction actions --signature XYZ, returns human-readable action list | | "Is this a known wallet?" | Calls account metadata --address, returns label/tags/domain if available |

Resources: Solscan Pro API Docs, Solscan Pro API FAQs