# API接口

{% hint style="info" %}
API 服务限 VIP 可用，升级 VIP 后可联系客服获取
{% endhint %}



## 一、规范说明

#### 请求结构

在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
    

```
