# 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
    

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alertdog.gitbook.io/home/support/api-jie-kou.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.