API接口

API 服务限 VIP 可用（距离VIP失效时长 > 三个月），联系客服获取

一、规范说明

请求结构

在header里加入 x-api-key 用来确认身份

二、接口定义

2.1 监控历史

• 接口说明： 获取solana监控历史

• 接口地址： /alertdog/monitor/xapi/solana/wallet/history

• 请求方式: GET

2.1.1 请求参数

参数名称	类型	出现要求	描述
pageFlip	string	option	允许传入 prev 和 next 两个值 prev: 查询大于 cursor id 的事件 , next: 查询小于 cursor id 的事件
cursor	int	option	cursor id 事件id
limit	int	option	每页数量 1000

请求示例：

curl --location --request GET 'https://api.mct.club/alertdog/monitor/xapi/solana/wallet/history?limit=20' \
--header 'accept: application/json, text/plain, */*' \
--header 'accept-language: zh-CN,zh;q=0.9,zh-TW;q=0.8,en;q=0.7' \
--header 'x-api-key: xxxx' \
--header 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36'

2.1.2 返回结果

参数名称	类型	出现要求	描述
page	object	R	前后页锚点
result	array	R	历史数据
result.event_type	Action	R	事件类型
result.event_time	int	R	事件触发时间
result.wallet	object	R	监控钱包
result.event	object	R	事件具体信息
result.event.lost_token_count	int	R	支出多少种代币
result.event.receive_token_count	int	R	收到多少种代币
result.event.action	Action	R	事件类型
result.event.Side	Action	R	方向
result.event.lost	array	R	支出明细
result.event.receive	array	R	收到明细
result.event.master_token	object	R	该事件主要目标代币

示例：

{
    "result": "Success",
    "data": {
        "page": {
            "next": 38646498,
            "prev": 38646501
        },
        "result": [
            {
                "id": 38646501,
                "event_type": 3,
                "event_time": 1744713051,
                "wallet": {
                    "name": "xxx",
                    "group": {
                        "id": 0,
                        "name": "xxx"
                    },
                    "address": {
                        "id": 20289,
                        "address": "xxxx",
                        "is_bot": 0
                    },
                    "notify_history_retention": 1,
                    "notify_merge": true,
                    "channels": null,
                    "token_action": null,
                    "token_condition": null,
                    "disabled": false,
                    "CreatedAt": "2025-02-05T21:02:01.655+08:00"
                },
                "event": {
                    "lost_token_count": 1,
                    "receive_token_count": 1,
                    "transaction": {
                        "id": 0,
                        "tx_hash": "xxxx",
                        "block_time": 1744713051,
                        "block_number": 333607874
                    },
                    "action": 3,
                    "side": 7,
                    "lost": [
                        {
                            "from": "xxxx",
                            "to": "xxxx",
                            "Mint": {
                                "mint": "GRsjgH1LDeFpj1wrpixouqSZj8HcySRX7YCFP2J3pump",
                                "decimal": 6,
                                "symbol": "YITLER",
                                "name": "Yitler"
                            },
                            "action": 2,
                            "side": 2,
                            "amount": "8865785542306",
                            "format_amount": "8865785.542306",
                            "token_price_snapshot": "0.000045672686178",
                            "token_mkt_cap_snapshot": "45672.686178"
                        }
                    ],
                    "receive": [
                        {
                            "from": "xxxx",
                            "to": "xxxxx",
                            "mint_id": 1,
                            "Mint": {
                                "id": 1,
                                "mint": "Sol",
                                "decimal": 9,
                                "symbol": "SOL",
                                "name": ""
                            },
                            "action": 4,
                            "side": 4,
                            "amount": "4345341335",
                            "format_amount": "4.345341335",
                            "token_price_snapshot": "132.9934813",
                            "token_mkt_cap_snapshot": ""
                        }
                    ],
                    "master_token": {
                        "id": 763858174,
                        "mint": "GRsjgH1LDeFpj1wrpixouqSZj8HcySRX7YCFP2J3pump",
                        "decimal": 6,
                        "symbol": "YITLER",
                        "name": "Yitler"
                    },
                    "CreatedAt": "2025-04-15T18:30:53.642+08:00"
                }
            },
        ]
    }
}

2.1.3 Action 值对应解释

值	描述
2	Send 支出
3	Trade 兑换
4	Receive 收到
5	mint 铸造
6	Buy 买入
7	Sell 卖出
8	Transfer 转移
9	Swap 交易
10	Listing 挂单
11	AirDrop 空投

2.1.4 示例

监控最新事件:

    https://api.mct.club/alertdog/monitor/xapi/solana/wallet/history?pageFlip=prev&cursor={上一次请求的prev值}&limit=100
    

获取历史事件:

    https://api.mct.club/alertdog/monitor/xapi/solana/wallet/history?pageFlip=next&cursor={上一次请求的next值}&limit=100