solscan-data

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Solscan Pro Skill

Solscan Pro 技能

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

支持AI Agent获取涵盖账户、代币、NFT、交易、区块、市场和程序的专业级Solana链上数据。

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

用户询问Solana钱包地址、余额、资产组合或质押情况
用户想要获取代币价格、持币者、市场或热门代币信息
用户需要检查交易签名或解码指令
用户询问NFT集合、NFT资产或近期NFT活动
用户想要查询DeFi活动、转账历史或奖励导出
用户想要分析程序的链上统计数据、交易指标或用户活动
用户需要查看热门DeFi平台或API使用情况

Authentication

身份验证

All requests require an API key in the HTTP header:

http

token: <YOUR_SOLSCAN_API_KEY>

Base URL:

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

所有请求都需要在HTTP头中携带API密钥：

http

token: <YOUR_SOLSCAN_API_KEY>

基础URL：

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

Tools

工具

Tool 1 — Direct API CLI (Precise Data)

工具1 — 直接API CLI（精准数据）

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]

适用场景：你需要获取特定地址、签名、区块或铸币的精准结构化链上数据时使用。

语法：

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

Tool 2 — MCP Natural Language Tools

工具2 — MCP自然语言工具

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

适用场景：回答通用探索性问题，或用户未提供特定地址时使用。

可用的MCP工具：

```
search_transaction_by_signature
```
— 按交易签名查询交易
```
get_account_balance
```
— 获取钱包的SOL余额
```
get_token_metadata
```
— 获取代币铸币的名称、符号、小数位数

API Reference

API参考

Account

账户（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)

Action	Key Params	Returns
`account detail`	`--address`	Lamports、所有者、可执行标记
`account data-decoded`	`--address`	解码后的账户数据
`account metadata`	`--address`	标签、图标、标记、域名、资助方
`account metadata-multi`	`--addresses`	批量元数据（逗号分隔）
`account transfer`	`--address [filters...]`	SPL + SOL转账历史（支持活动类型、代币、流向、时间范围筛选）
`account defi`	`--address [filters...]`	DeFi协议交互记录（活动类型、来源、平台、源地址、代币、时间范围）
`account balance-change`	`--address [filters...]`	历史余额变动（代币、流向、金额、时间范围、移除垃圾数据）
`account transactions`	`--address [--before] [--limit]`	近期交易列表（基于游标分页）
`account portfolio`	`--address [--exclude-low-score-tokens]`	带USD估值的代币持仓
`account tokens`	`--address --type [--page] [--page-size] [--hide-zero]`	关联的代币/NFT账户（每页数量：10/20/30/40）
`account stake`	`--address [--page] [--page-size] [--sort-by] [--sort-order]`	活跃质押账户（每页数量：10/20/30/40）
`account reward-export`	`--address [--time-from] [--time-to]`	质押奖励历史CSV（最多5000条，每分钟最多1次请求）
`account transfer-export`	`--address [filters...]`	转账历史CSV（最多5000条，每分钟最多1次请求）
`account leaderboard`	`[--sort-by] [--sort-order] [--page] [--page-size]`	活跃度最高的账户排名
`account defi-export`	`--address [filters...]`	DeFi活动CSV（最多5000条，每分钟最多1次请求）

account metadata
返回字段：

account_address

account_label

account_icon

account_tags

account_type

account_domain

funded_by

tx_hash

block_time

account transfer
筛选选项：

--activity-type
: 转账类型筛选（逗号分隔）。可选值：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
: 筛选钱包内指定代币账户的转账记录
--from
: 按源地址筛选（最多5个，逗号分隔）
--exclude-from
: 排除指定源地址的转账记录（最多5个，逗号分隔）
--to
: 按接收地址筛选（最多5个，逗号分隔）
--exclude-to
: 排除指定接收地址的转账记录（最多5个，逗号分隔）
--token
: 按代币地址筛选（最多5个，逗号分隔）。原生SOL使用地址
So11111111111111111111111111111111111111111
--amount
: 金额范围筛选（最小值最大值）
--value
: USD价值范围筛选（最小值最大值）
--from-time
,
--to-time
: Unix时间戳范围筛选
--exclude-amount-zero
: 排除金额为0的转账（布尔值）
--flow
: 转账方向：in（转入）|out（转出）
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）
--sort-order
: 排序方向：asc（升序）|desc（降序，默认）
已废弃参数：
sort_by
,
block_time
（请使用
from_time
/
to_time
替代）

account defi
筛选选项：

--activity-type
: 活动类型筛选（逗号分隔）。可选值：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
: 按活动发起地址筛选
--platform
: 按平台地址筛选（逗号分隔，最多5个）
--source
: 按源地址筛选（逗号分隔，最多5个）
--token
: 按代币地址筛选
--from-time
,
--to-time
: Unix时间戳范围筛选
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）
--sort-by
: 排序字段（默认：block_time，可选值：block_time）
--sort-order
: 排序方向：asc|desc（默认：desc）
已废弃参数：
block_time
（请使用
from_time
/
to_time
替代）

account balance-change
筛选选项：

--token-account
: 按指定代币账户筛选
--token
: 按代币地址筛选
--amount
: 金额范围（最小值最大值）
--flow
: in|out
--remove-spam
: true|false
--from-time
,
--to-time
: Unix时间戳范围
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）
--sort-by
: 排序字段（默认：block_time，可选值：block_time）
--sort-order
: 排序方向：asc|desc（默认：desc）
已废弃参数：
block_time
（请使用
from_time
/
to_time
替代）

account transactions
分页规则：

使用基于游标的分页，参数为
--before
（交易签名）
--limit
: 10, 20, 30, 40（默认：10）
无page/page_size参数

account stake
选项：

--sort-by
: active_stake|delegated_stake（默认：active_stake）
--sort-order
: asc|desc
--page-size
: 10, 20, 30, 40（默认：10）

account reward-export
参数：

--time-from
: 开始时间（Unix时间戳，单位秒，默认：time-to的1个月前）
--time-to
: 结束时间（Unix时间戳，单位秒，默认：当前时间）

account transfer-export
筛选选项：

--activity-type
: 转账类型筛选（逗号分隔）。可选值：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
: 按指定代币账户地址筛选
--from
: 按源地址筛选
--to
: 按接收地址筛选
--token
: 按代币地址筛选（原生SOL使用地址
So11111111111111111111111111111111111111111
）
--amount
: 金额范围（最小值最大值）
--from-time
,
--to-time
: Unix时间戳范围
--exclude-amount-zero
: 排除金额为0的转账
--flow
: 转账方向：in|out
已废弃参数：
block_time
（请使用
from_time
/
to_time
替代）

account leaderboard
选项：

--sort-by
: sol_values|stake_values|token_values|total_values（默认：total_values）
--sort-order
: asc|desc
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）

account defi-export
筛选选项：

--activity-type
: 活动类型筛选（逗号分隔）。可选值：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
: 按活动发起地址筛选
--platform
: 按平台地址筛选（逗号分隔，最多5个）
--source
: 按源地址筛选（逗号分隔，最多5个）
--token
: 按代币地址筛选
--from-time
,
--to-time
: Unix时间戳范围
--sort-by
: 排序字段（默认：block_time，可选值：block_time）
--sort-order
: 排序方向：asc|desc（默认：desc）
已废弃参数：
block_time
（请使用
from_time
/
to_time
替代）

Token

代币（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] [--from-value] [--to-value]`	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
`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)
--page
: Page number (default: 1)
--page-size
: 10, 20, 30, 40 (default: 10)
--from-amount
: Minimum token holding amount (string format, optional)
--to-amount
: Maximum token holding amount (string format, optional)
--from-value
: Minimum token holding value in USD (optional)
--to-value
: Maximum token holding value in USD (optional)

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

Action	Key Params	Returns
`token meta`	`--address`	名称、符号、小数位数、发行量
`token meta-multi`	`--addresses`	批量元数据
`token price` ⚠️	`--address [--from-time] [--to-time]`	已废弃 - 单个代币价格历史（请使用 `token price-history` 替代）
`token price-multi` ⚠️	`--addresses [--from-time] [--to-time]`	已废弃 - 批量价格历史（请使用 `token price-history` 替代）
`token price-latest`	`--addresses`	多个代币的最新价格（最多50个，逗号分隔）
`token price-history`	`--addresses [--from-time] [--to-time]`	多个代币的历史价格（最多50个，逗号分隔；时间格式：YYYYMMDD）
`token holders`	`--address [--page] [--page-size] [--from-amount] [--to-amount] [--from-value] [--to-value]`	持币量排名前的持币者列表（每页数量：10/20/30/40）
`token markets`	`--token [--sort-by] [--program] [--page] [--page-size]`	DEX市场：传入1个代币地址返回所有相关市场，传入2个代币地址返回交易对
`token transfers`	`--address [filters...]`	转账历史
`token defi`	`--address [filters...]`	DeFi活动
`token defi-export`	`--address [filters...]`	DeFi活动CSV
`token historical`	`--address [--range]`	代币的历史数据（价格、交易量、持币者、交易者等，时间范围：7或30天，默认7天）
`token search`	`--keyword [--search-mode] [--search-by] [--sort-by] [--sort-order] [--page] [--page-size]`	按关键词/地址/名称/符号搜索代币
`token trending`	`[--limit]`	当前热门代币
`token list`	`[--page] [--page-size] [--sort-by] [--sort-order]`	完整代币列表（排序维度：持币者数
`token top`	—	市值排名靠前的代币
`token latest`	`[--platform-id] [--page] [--page-size]`	新上线代币（每页数量：10/20/30/40/60/100）

token price
参数 ⚠️ 已废弃:

--address
: 代币地址（必填）
--from-time
: 开始时间，格式YYYYMMDD（可选）
--to-time
: 结束时间，格式YYYYMMDD（可选）

token price-multi
参数 ⚠️ 已废弃:

--addresses
: 代币地址，逗号分隔（最多50个，必填）
--from-time
: 开始时间，格式YYYYMMDD（可选）
--to-time
: 结束时间，格式YYYYMMDD（可选）

token price-latest
参数:

--addresses
: 代币地址，逗号分隔（最多50个，必填）

token price-history
参数:

--addresses
: 代币地址，逗号分隔（最多50个，必填）
--from-time
: 开始时间，格式YYYYMMDD（可选）
--to-time
: 结束时间，格式YYYYMMDD（可选）

token holders
参数:

--address
: 代币地址（必填）
--page
: 页码（默认：1）
--page-size
: 10, 20, 30, 40（默认：10）
--from-amount
: 最小持币量（字符串格式，可选）
--to-amount
: 最大持币量（字符串格式，可选）
--from-value
: 最小持币USD价值（可选）
--to-value
: 最大持币USD价值（可选）

token markets
参数:

--token
: 代币地址（必填，1个地址返回所有相关市场，2个地址返回对应交易对，逗号分隔）
--sort-by
: 排序字段：volume|trade|tvl|trader
--program
: 按DEX程序筛选（逗号分隔，最多5个）
--page
: 页码（默认：1）
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）

token transfers
筛选选项:

--activity-type
: 转账类型筛选（逗号分隔）。可选值：ACTIVITY_SPL_TRANSFER, ACTIVITY_SPL_BURN, ACTIVITY_SPL_MINT, ACTIVITY_SPL_CREATE_ACCOUNT, ACTIVITY_SPL_CLOSE_ACCOUNT等
--from
: 按源地址筛选（最多5个，逗号分隔）
--exclude-from
: 排除指定源地址的转账（最多5个，逗号分隔）
--to
: 按接收地址筛选（最多5个，逗号分隔）
--exclude-to
: 排除指定接收地址的转账（最多5个，逗号分隔）
--amount
: 金额范围（最小值最大值）
--value
: USD价值范围（最小值最大值）
--exclude-amount-zero
: 排除金额为0的转账（布尔标记）
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）
--sort-by
: block_time（默认：block_time）
--sort-order
: asc|desc（默认：desc）

token defi
筛选选项:

--activity-type
: 活动类型筛选（逗号分隔）。可选值：ACTIVITY_TOKEN_SWAP, ACTIVITY_AGG_TOKEN_SWAP, ACTIVITY_TOKEN_ADD_LIQ, ACTIVITY_TOKEN_REMOVE_LIQ, ACTIVITY_POOL_CREATE等
--from
: 按活动发起地址筛选
--platform
: 按平台地址筛选（逗号分隔，最多5个）
--source
: 按源地址筛选（逗号分隔，最多5个）
--token
: 按代币地址筛选
--from-time
,
--to-time
: Unix时间戳范围筛选
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）
--sort-by
: block_time（默认：block_time）
--sort-order
: asc|desc（默认：desc）

token defi-export
筛选选项:

--activity-type
: 活动类型筛选（逗号分隔）：ACTIVITY_TOKEN_SWAP, ACTIVITY_AGG_TOKEN_SWAP等
--from
: 按活动发起地址筛选
--platform
: 按平台地址筛选（逗号分隔，最多5个）
--source
: 按源地址筛选（逗号分隔，最多5个）
--token
: 按代币地址筛选
--from-time
,
--to-time
: Unix时间戳范围筛选
--sort-by
: block_time（默认：block_time）
--sort-order
: asc|desc（默认：desc）

token historical
参数:

--address
: 代币地址（必填）
--range
: 7或30天（默认：7）

token search
参数:

--keyword
: 搜索词（必填）
--search-by
: combination|address|name|symbol（默认：combination）
--search-mode
: exact|fuzzy（默认：exact）
--exclude-unverified-token
: 排除未验证代币（布尔标记）
--sort-by
: reputation|market_cap|volume_24h（默认：reputation）
--sort-order
: asc|desc（默认：desc）
--page
,
--page-size
: 10, 20, 30, 40（默认：10）

token latest
支持的平台:

--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

交易（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)

Action	Key Params	Returns
`transaction detail`	`--tx`	完整交易详情（代币和SOL余额变动、IDL数据、每条指令对应的DeFi或转账活动）
`transaction detail-multi`	`--txs`	批量交易详情（最多50笔交易）
`transaction last`	`[--limit] [--filter]`	最新交易
`transaction actions`	`--tx`	人类可读的解码后活动（转账、兑换活动、NFT活动等）
`transaction actions-multi`	`--txs`	批量解码后活动（最多50笔交易）
`transaction fees`	—	网络手续费统计（无参数）

transaction last
参数:

--limit
: 返回的交易数量（10, 20, 30, 40, 60, 100，默认：10）
--filter
: 筛选类型（exceptVote|all，默认：exceptVote）

transaction detail
参数:

--tx
: 交易签名（必填，长度：30-100字符）

transaction detail-multi
参数:

--txs
: 交易签名，逗号分隔（必填，最多50个，每个长度30-100字符）

transaction actions
参数:

--tx
: 交易签名（必填，长度：30-100字符）

transaction actions-multi
参数:

--txs
: 交易签名，逗号分隔（必填，最多50个，每个长度30-100字符）

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)

Action	Key Params	Returns
`nft news`	`--filter [--page] [--page-size]`	最新NFT活动信息流（筛选维度：created_time，每页数量：12/24/36）
`nft activities`	`[filters...]`	NFT活动（所有筛选器可选：来源、去向、源地址、活动类型、代币、集合、计价代币、价格、时间范围）
`nft collections`	`[--range] [--sort-by] [--sort-order] [--collection] [--page] [--page-size]`	热门NFT集合（时间范围：1/7/30天，排序维度：藏品数/地板价/交易量）
`nft items`	`--collection [--sort-by] [--page] [--page-size]`	集合内的NFT藏品（排序维度：last_trade/listing_price，每页数量：12/24/36）

nft activities
参数（全部可选）:

--from
,
--to
: 按地址筛选
--source
: 按源地址筛选（逗号分隔，最多5个）
--activity-type
: 活动类型（逗号分隔）。可选值：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
: 代币地址
--collection
: 集合地址
--currency-token
: 计价代币地址
--price
: 价格范围筛选（最小值最大值，需要搭配currency_token参数）
--from-time
,
--to-time
: Unix时间戳范围
--page-size
: 10, 20, 30, 40, 60, 100（默认：10）
--block-time
⚠️ 已废弃: 请使用
--from-time
/
--to-time
替代

nft collections
参数（全部可选）:

--range
: 时间范围天数（1,7,30，默认：1）
--sort-by
: 排序字段（items, floor_price, volumes，默认：volumes）
--sort-order
: 排序方向（asc, desc，默认：desc）
--collection
: 按集合ID筛选
--page
: 页码（默认：1）
--page-size
: 10, 20, 30, 40（默认：10）

nft items
参数:

--collection
: 集合地址（必填）
--sort-by
: 排序字段（last_trade, listing_price，默认：last_trade）
--page
: 页码（默认：1）
--page-size
: 12, 24, 36（默认：12）

Block

区块（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)

Action	Key Params	Returns
`block last`	`[--limit]`	获取最新区块列表
`block detail`	`--block`	获取区块详情
`block transactions`	`--block [--page] [--page-size] [--exclude-vote] [--program]`	获取区块内的交易列表

block last
参数:

--limit
: 返回的区块数量（10, 20, 30, 40, 60, 100，默认：10）

block detail
参数:

--block
: 区块的插槽索引（必填，最小值：0）

block transactions
参数:

--block
: 区块的插槽索引（必填，最小值：0）
--page
: 分页页码（默认：1）
--page-size
: 每页条目数（10, 20, 30, 40, 60, 100，默认：10）
--exclude-vote
: 从结果中排除投票交易（布尔标记，默认：false）
--program
: 筛选与指定程序交互的交易（可选，字符串）

Market

市场（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)

Action	Key Params	Returns
`market list`	`[--page] [--page-size] [--program] [--token-address] [--sort-by] [--sort-order]`	所有交易池/市场（排序维度：created_time\|volumes_24h\|trades_24h）
`market info`	`--address`	按地址获取市场/交易池详情
`market volume`	`--address [--time]`	获取市场历史数据和交易量

market list
参数:

--page
: 页码（默认：1）
--page-size
: 每页条目数（10, 20, 30, 40, 60, 100，默认：10）
--program
: 程序所有者地址（可选）
--token-address
: 市场涉及的代币地址（可选）
--sort-by
: 排序字段（created_time, volumes_24h, trades_24h，默认：volumes_24h）
--sort-order
: 排序方向（asc, desc，默认：desc）

market info
参数:

--address
: 市场ID/地址（必填，最小长度：30字符）

market volume
参数:

--address
: 市场ID/地址（必填，最小长度：30字符）
--time
: 按YYYYMMDD格式的时间范围筛选数据。传入开始和结束日期筛选时间范围（例如
--time 20240701 20240715
）。支持1-2个值（可选）

Program

程序（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)

Action	Key Params	Returns
`program list`	`[--sort-by] [--sort-order] [--page] [--page-size]`	过去90天活跃的程序（排序维度：num_txs\|num_txs_success\|interaction_volume\|success_rate\|active_users_24h）
`program popular-platforms`	—	热门DeFi平台
`program analytics`	`--address --range`	任意Solana程序的程序级分析数据（时间范围：7或30天，必填）

program list
参数:

--sort-by
: 排序字段（num_txs, num_txs_success, interaction_volume, success_rate, active_users_24h，默认：num_txs）
--sort-order
: 排序方向（asc, desc）
--page
: 页码（默认：1）
--page-size
: 10, 20, 30, 40（默认：10）

program analytics
参数:

--address
: Solana区块链上的程序地址（必填，最小长度：30字符）
--range
: 分析时间范围，单位天（7或30，必填）

Monitor

监控（Monitor）

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

Action	Key Params	Returns
`monitor usage`	—	你的API密钥使用情况与速率限制

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.

HTTP Code	含义	Agent处理动作
`400`	请求错误 / 无效地址	验证地址格式后重试
`401`	身份验证失败	检查 `token` 请求头是否设置正确
`429`	超出速率限制	等待后使用退避策略重试
`500`	服务器内部错误	重试一次；如果问题持续则上报

所有错误响应都包含

success: false

、

code

和

message

字段。

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

步骤1:
```
account metadata --address <ADDR>
```
→ 确认标签和类型
步骤2:
```
account portfolio --address <ADDR>
```
→ 获取代币持仓
步骤3:
```
account transfer --address <ADDR>
```
→ 查看近期活动
步骤4:
```
account defi --address <ADDR>
```
→ 检查协议交互情况

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

步骤1:
```
token meta --address <MINT>
```
→ 确认代币身份
步骤2:
```
token price --address <MINT>
```
→ 获取当前价格
步骤3:
```
token holders --address <MINT>
```
→ 检查集中度风险
步骤4:
```
token markets --token <MINT>
```
→ 查找最优流动性池

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

查询	预期行为
"钱包 `ABC123` 持有哪些代币？"	调用 `account portfolio --address ABC123` ，返回带USD估值的代币列表
"BONK的当前价格是多少？"	调用 `token meta` 解析铸币地址，再调用 `token price` ，返回USD价格
"解码交易 `XYZ...` "	调用 `transaction actions --signature XYZ` ，返回人类可读的活动列表
"这是已知钱包吗？"	调用 `account metadata --address` ，返回可用的标签/标记/域名信息

资源: Solscan Pro API 文档, Solscan Pro API 常见问题