MoneyScan API Docs

API 服务声明

1. 个人版 API 服务适用于通过程序自动化筛选找出某类聪明钱地址，不适用于批量、持续拉取数据

2. 如有其他聚合类查询需求，可联系团队提供接口

3. 使用过程如遇到任何问题，可随时私信团队前台：@过千山

4. 付费前请认真评估文档所提供功能是否满足需求，或咨询团队前台，付费后无退款服务哟！

5. 统计数据均取地址在统计周期内的完整交易计算，周期内未买入卖出不纳入计算

6. 最大请求并发数暂设为 10 req/s

Base URL

https://moneyscan.ai/api/v1/external/traderData

请求鉴权

api key 通过 query parameter 认证

https://moneyscan.ai/api/v1/external/traderData/{interface}?api-key=your_api_key

额度使用说明

1. 同一额度周期内，已查询过的地址重复查询，不消耗查询额度

2. 20% 的地址数据是免费数据，如查询地址为免费地址数据，不消耗查询额度

根据条件查询交易者

POST /queryTradersByCondition

根据条件查询交易者

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description	是否必需
cursor_pnl	int	上一页请求返回的游标，如获取第一页填 0	是
cursor_id	int	上一页请求返回的游标，如获取第一页填 0	是
date_range	int	统计周期	是
min_token_win_rate	float	最低币种交易胜率，如 0.5 -> 50%	否
max_token_win_rate	float	最高币种交易胜率	否
min_pnl	int	最小已实现利润，精度说明	否
max_pnl	int	最大已实现利润，默认10M	否
min_roi	float	最小 roi，如 0.5 -> 50%	否
max_roi	float	最大 roi	否
min_buy_count	int	最少买入次数	否
max_buy_count	int	最大买入次数	否
min_sell_count	int	最少卖出次数	否
max_sell_count	int	最多卖出次数	否
min_avg_buy_amount	int	最小平均买入金额	否
max_avg_buy_amount	int	最大平均买入金额	否
min_main_profit_source_count	int	最小主要（80%）利润来源数	否
max_main_profit_source_count	int	最大主要（80%）利润来源数	否
holding_time_preference	[]string	持仓时间偏好，入参选项加可选值说明	否
trading_fund_preference	[]string	交易资金量偏好	否
market_cap_preference	[]string	市值偏好	否
token_age_preference	[]string	代币年龄偏好	否
last_update_time	int	数据更新时间必须在这个时间戳之后，默认三天	否
platform_code	string	是哪个交易平台的用户，默认 "0" 表示所有平台	否
min_platform_count	int	最少要在这个平台交易多少次	否
latest_trade_time	int	最近一次交易必须在这个时间戳之后	否
start_first_trade_time	int	首次交易时间必须在这个时间戳之后	否
end_first_trade_time	int	首次交易时间必须在这个时间戳之前	否

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "traders": [
            {
                "trader": "MoneyScan_ji9U8XgTpReLfj7pXPY4ox6qoecdLcJ4GbmNWJBCHdQe",
                "date_range": 7,
                "pnl": 1892622586,
                "buy_count": 520,
                "sell_count": 83,
                "token_win_rate": 1,
                "roi": 6.0765,
                "avg_buy_amount": 632468,
                "first_trade_time": 1749520800,
                "last_trade_time": 1753556400,
                "holding_time_preference": [
                    "30m-2h"
                ],
                "trading_fund_preference": [
                    "10-100U"
                ],
                "market_cap_preference": [
                    "<100K"
                ],
                "token_age_preference": [
                    "5m-30m",
                    "<5m"
                ],
                "main_profit_source_count": 13,
                "platform_trade_count": 34,
                "trade_platform": {
                    "1": 16,
                    "12": 18
                },
                "trade_platform_raw": null,
                "update_time": 1753585200,
                "balance": 2099455718,
                "is_free": false
            }
        ],
        "is_encoded": true,
        "page_size": 25,
        "cursor_pnl": 187058635,
        "cursor_id": 4916953,
        "has_next": true
    }
}

400

返回值字段

Name	Type	Description
trader	string	经过编码处理的交易者地址
date_range	int	统计周期
pnl	int	已实现利润
buy_count	int	买入次数
sell_count	int	卖出次数
token_win_rate	float	币种交易胜率
roi	float	ROI
avg_buy_amount	int	平均买入金额
first_trade_time	int	半年内最早交易时间戳（秒）
last_trade_time	int	最近一次交易时间戳（秒）
holding_time_preference	[]string	持仓时间偏好
trading_fund_preference	[]string	交易资金量偏好
market_cap_preference	[]string	代币市值偏好
token_age_preference	[]string	代币年龄偏好
main_profit_source_count	int	主要利润来源数
platform_trade_count	int	各交易平台总计交易次数
trade_platform	-	各交易平台的具体交易次数
update_time	int	数据更新时间戳（秒）
balance	int	地址 SOL 余额
is_encoded	bool	trader 地址是否经过编码处理
trade_platform_raw	-	无效字段
is_free	-	无效字段
page_size	int	默认一次最大返回25行数据
cursor_pnl	int	用于获取下一页的游标
cursor_id	int	用于获取下一页的游标
has_next	bool	是否还有下一页

额度消耗：0

查询 Trader 详细交易数据

POST /queryTrader

查询 Trader 详细交易数据

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description	是否必需
address	string	交易者地址/交易者编码地址	是
date_range	int	统计周期	是
is_encoded	bool	传入的地址是否经过编码处理	是

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "trader": "8nTPcy2qi2cX3WC9cCS1TQu4k1tV4Dk979dHc2FGX1bB",
        "encoded_address": "MoneyScan_vhHau2vJZdGfWBa4NHEQhDogzaQJYftuifVNTimMVf35",
        "is_encoded": false,
        "date_range": 180,
        "pnl": 110393802,
        "buy_count": 890,
        "sell_count": 505,
        "token_win_rate": 0.4853,
        "sell_win_rate": 0.5683,
        "roi": 0.1463,
        "avg_buy_amount": 904937,
        "holding_time_preference": [
            "1-5m",
            "10s-1m"
        ],
        "trading_fund_preference": [
            "100-1KU"
        ],
        "market_cap_preference": [
            "1M-10M",
            "10M-100M"
        ],
        "token_age_preference": [
            "5m-30m",
            "30m-2h"
        ],
        "update_time": 1754859600,
        "first_trade_time": 1736690400,
        "last_trade_time": 1751328000,
        "total_token_count": 307,
        "total_profit_token_count": 149,
        "total_loss_token_count": 153,
        "total_profit": 149895659,
        "total_loss": -39501857,
        "total_buy_amount": 805394123,
        "total_realized_cost": 754696577,
        "main_profit_source_count": 10,
        "main_profit_source": [
            {
                "token_name": "OFFICIAL TRUMP",
                "token_symbol": "TRUMP",
                "token": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
                "pnl": 59301350,
                "cost": 63419247,
                "realized_cost": 63419247,
                "cost_pct": 0.0787,
                "pnl_pct": 0.3956,
                "roi": 0.9351,
                "token_source": 0,
                "fb_time": 1737168405,
                "fb_mc": 2303093214026,
                "fb_age": 45946,
                "hold_time": 60
            },
        ],
        "main_loss_source_count": 0,
        "main_loss_source": [
            {
                "token_name": "Monke Phone",
                "token_symbol": "MONKEPHONE",
                "token": "hxcxN81ma8m5PMzPuCyysaMJ9wqJenBr811DbX4moon",
                "pnl": -6670122,
                "cost": 29848521,
                "realized_cost": 29848521,
                "cost_pct": 0.0371,
                "pnl_pct": 0.1689,
                "roi": -0.2235,
                "token_source": 132,
                "fb_time": 1750996516,
                "fb_mc": 1659887826,
                "fb_age": 129621,
                "hold_time": 167478
            },
        "no_buy_token_count": 5,
        "no_buy_token_details": [
            {
                "token_name": "Ansem's minutes",
                "token_symbol": "Ansem",
                "token": "HAs8hvTB8ZH6dBG26KQGik4fxitNYi41jnYd49bvtime",
                "value": 1542276,
                "token_source": 0
            },
        "is_platform_trader": true,
        "trade_platform": {
            "12": 290,
            "6": 66
        },
        "is_kol": false,
        "kol_name": "",
        "kol_x_link": "",
        "kol_img_url": "",
        "is_dev": false,
        "dev_count": 0,
        "dev_details": [],
        "is_an_trader": false,
        "an_details": [
            {
                "an_type": "A6",
                "an_count": 0
            },
            {
                "an_type": "A7",
                "an_count": 0
            },
            {
                "an_type": "A8",
                "an_count": 0
            }
        ],
        "balance": 158251043
    }
}

400

返回值字段

Name	Type	Description
trader	string	交易者地址（无编码）
encoded_address	string	编码处理后的交易者地址
is_encoded	bool	交易者地址是否经过编码
date_range	int	统计周期
pnl	int	已实现利润
buy_count	int	买入次数
sell_count	int	卖出次数
token_win_rate	float	币种交易胜率
sell_win_rate	float	卖出交易胜率（用于区别买得对卖得错的情况）
roi	float	ROI
avg_buy_amount	int	平均买入金额
holding_time_preference	[]string	持仓时间偏好
trading_fund_preference	[]string	交易资金量偏好
market_cap_preference	[]string	代币市值偏好
token_age_preference	[]string	代币年龄偏好
update_time	int	数据更新时间
first_trade_time	int	半年内首次交易时间
last_trade_time	int	最近一次交易时间
total_token_count	int	总共交易多少种代币
total_profit_token_count	int	盈利代币数
total_loss_token_count	int	亏损代币数
total_profit	int	总盈利金额
total_loss	int	总亏损金额
total_buy_amount	int	总买入金额
total_realized_cost	int	总共的已实现利润的成本
main_profit_source_count	int	主要利润来源数
main_profit_source	-	主要利润来源明细
main_loss_source_count	int	主要亏损来源数
main_loss_source	-	主要亏损来源明细
token_name	string	代币名称
token_symbol	string	代币 symbol
token	string	代币地址
cost	int	单币成本
realized_cost	int	单币已实现利润的成本
cost_pct	float	成本占比
pnl_pct	float	pnl 占比
token_source	int	代币发行平台
fb_time	int	首次买入时间戳
fb_mc	int	首次买入时代币市值
fb_age	int	首次买入时代币年龄
hold_time	int	持仓时长时间戳
no_buy_token_count	int	统计周期内未买入卖出数
no_buy_token_details	-	统计周期内未买入卖出代币明细
value	int	统计周期内未买入卖出单币金额
is_platform_trader	bool	是否是交易平台用户
trade_platform	-	在各交易平台的交易次数明细
is_kol	bool	是否是 KOL
kol_name	string	KOL 名称
kol_x_link	string	KOL X 平台链接
is_dev	bool	是否是 dev
dev_count	int	dev 次数
dev_details	-	dev 明细
is_an_trader	bool	是否创造过 单币A6,7,8
an_details	-	单币大额盈利明细
balance	int	地址 SOL 余额

地址查询额度消耗：20

查询代币前排买入地址

POST /queryEarlyTraderByToken

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description	是否必需
token	string	代币地址	是
is_include_180	bool	是否查询180天数据 - 若不查询，默认为 30 天内数据 - 数据量较大，查询稍慢	否

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "token_name": "OFFICIAL TRUMP",
        "token_symbol": "TRUMP",
        "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
        "token_source": 0,
        "is_encoded": false,
        "detail_list": [
            {
                "trader": "8p9bYKWxWqXQyTGFeRw2RL4PvRWpxXNNReUdpHXHQjg",
                "date_range": 180,
                "balance": 0,
                "detail": {
                    "token_name": "OFFICIAL TRUMP",
                    "token_symbol": "TRUMP",
                    "token": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
                    "pnl": 7452556,
                    "cost": 408022944,
                    "realized_cost": 407101651,
                    "cost_pct": 0.2381,
                    "pnl_pct": 0.1802,
                    "roi": 0.0183,
                    "token_source": 0,
                    "fb_time": 1737165693,
                    "fb_mc": 182426534049,
                    "fb_age": 43234,
                    "hold_time": 3632879
                }
            },
        ]
    }
}

400

返回值字段

其他返回值参考上述文档

Name	Type	Description
token_source	int	代币发行平台
is_encoded	bool	trader 地址是否经过编码处理

查询工具额度消耗：1

查询代币盈利地址

POST /queryProfitTraderByToken

<Description of the endpoint>

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description	是否必需
token	string	代币地址	是
is_include_180	bool	是否查询180天数据 - 若不查询，默认为 30 天内数据 - 数据量较大，查询稍慢	否

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "token_name": "OFFICIAL TRUMP",
        "token_symbol": "TRUMP",
        "token_address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
        "token_source": 0,
        "is_encoded": false,
        "detail_list": [
            {
                "trader": "8p9bYKWxWqXQyTGFeRw2RL4PvRWpxXNNReUdpHXHQjg",
                "date_range": 180,
                "balance": 0,
                "detail": {
                    "token_name": "OFFICIAL TRUMP",
                    "token_symbol": "TRUMP",
                    "token": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
                    "pnl": 7452556,
                    "cost": 408022944,
                    "realized_cost": 407101651,
                    "cost_pct": 0.2381,
                    "pnl_pct": 0.1802,
                    "roi": 0.0183,
                    "token_source": 0,
                    "fb_time": 1737165693,
                    "fb_mc": 182426534049,
                    "fb_age": 43234,
                    "hold_time": 3632879
                }
            },
        ]
    }
}

400

返回值字段

其他返回值参考上述文档

Name	Type	Description
token_source	int	代币发行平台
is_encoded	bool	trader 地址是否经过编码处理

查询工具额度消耗：1

查询多代币共同盈利地址

POST /querySameProfitTraderByTokens

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description	是否必需
tokens	[]string	代币地址，列表传入	是
is_include_180	bool	是否查询180天数据 - 若不查询，默认为 30 天内数据 - 数据量较大，查询稍慢	否

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "is_encoded": false,
        "trader_list": [
            {
                "trader": "6MBsqxPeRfFfjC1YZQhMGRHt6si6qfQfWTzQYFGEYYBY",
                "total_pnl": 12635,
                "total_cost": 107546,
                "balance": 1875237146
            }
        ]
    }
}

400

返回值字段

Name	Type	Description
total_pnl	int	多个代币合计 pnl
total_cost	int	多个代币合计成本
is_encoded	bool	trader 地址是否经过编码处理
balance	int	地址 SOL 余额

额度消耗：1

查询多代币共同前排地址

POST /querySameEarlyTraderByTokens

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description	是否必需
tokens	[]string	代币地址，列表传入	是
is_include_180	bool	是否查询180天数据 - 若不查询，默认为 30 天内数据 - 数据量较大，查询稍慢	否
token_age	int	代币创建后多久内买入，输入秒数	是

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "is_encoded": false,
        "trader_list": [
            {
                "trader": "6MBsqxPeRfFfjC1YZQhMGRHt6si6qfQfWTzQYFGEYYBY",
                "total_pnl": 12635,
                "total_cost": 107546,
                "balance": 1875237146
            }
        ]
    }
}

400

返回值字段

Name	Type	Description
total_pnl	int	多个代币合计 pnl
total_cost	int	多个代币合计成本
is_encoded	bool	trader 地址是否经过编码处理
balance	int	地址 SOL 余额

查询工具额度消耗：1

查询剩余额度

POST /getUserCreditInfo

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
无入参	-	无需入参，直接查询

Response

200

{
    "code": 200,
    "message": "success",
    "data": {
        "query_trader_detail_credit_left": 160000,
        "query_trader_detail_credit_limit": 160000,
        "query_tool_credit_left": 598,
        "query_tool_credit_limit": 600,
        "credit_cycle_end_at": 1757450112
    }
}

400

返回值字段

Name	Type	Description
query_trader_detail_credit_left	int	剩余 Trader 详细交易数据查询额度
query_trader_detail_credit_limit	int	总共 Trader 详细交易数据额度
query_tool_credit_left	int	剩余查询工具使用额度
query_tool_credit_limit	int	全部查询工具使用额度
credit_cycle_end_at	int	额度周期结束时间

额度消耗：0

其他说明

精度说明

1. SOL 余额精度 9 位

2. 所有涉及 USD 金额的值均为 3 位精度，如 1000169 -> 1000.169 u

入参可选值

统计周期（日）

1, 3, 7, 30, 180

持仓时间偏好

["<10s", "10s-1m", "1-5m", "5-30m", "30m-2h", "2h-6h", "6h-12h", "12h-1d", "1-3d", ">3d"]

交易资金量偏好

["<10U", "10-100U", "100-1KU", "1K-10KU", "10K-100KU", "100K+"]

市值偏好

["<100K", "100K-1M", "1M-10M", "10M-100M", "100M-1B", "1B+"]

代币年龄偏好

["<5m", "5m-30m", "30m-2h", "2h-12h", "12h-1d", "1-3d", "3d-1w", "1w-1month", "1month-3month", ">3month"]

映射值

Token Source

Code	Platform
0	无
1	Pump
2	Raydium
4	Raydium
10	Raydium
11	Meteora
13	Meteora
14	OBRIC
15	Boop
101	BONK
131	Believe
132	Moonshot
133	Jup

trade_platform

Code	Platform
1	GMGN
2	BullX
3	Photon
4	Moonshot
5	Axiom
6	XXYY
7	Bloom
8	BONK Bot
9	Trojan
10	Maestro
11	Banana Gun
12	OKX
13	Binance