# MoneyScan API Docs

## API 服务声明

1. 个人版 API 服务适用于通过程序自动化筛选找出某类聪明钱地址，不适用于批量、持续拉取数据
2. 如有其他聚合类查询需求，可联系团队提供接口
3. 使用过程如遇到任何问题，可随时私信团队前台：[@过千山](https://x.com/GQianShan)
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><br>

## 额度使用说明

1. 同一额度周期内，已查询过的地址重复查询，不消耗查询额度
2. 20% 的地址数据是免费数据，如查询地址为免费地址数据，不消耗查询额度

## 根据条件查询交易者

<mark style="color:green;">`POST`</mark>  `/queryTradersByCondition`

根据条件查询交易者

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

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

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "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
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段

| 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 详细交易数据

<mark style="color:green;">`POST`</mark>  `/queryTrader`

查询 Trader 详细交易数据

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="166.78125">Name</th><th>Type</th><th width="315.3359375">Description</th><th>是否必需</th></tr></thead><tbody><tr><td>address</td><td>string</td><td>交易者地址/交易者编码地址</td><td>是</td></tr><tr><td>date_range</td><td>int</td><td>统计周期</td><td>是</td></tr><tr><td>is_encoded</td><td>bool</td><td>传入的地址是否经过编码处理</td><td>是</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "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
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段 <a href="#fhz" id="fhz"></a>

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

### 地址查询额度消耗：20

## 查询代币前排买入地址

<mark style="color:green;">`POST`</mark>  `/queryEarlyTraderByToken`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th>Name</th><th width="168.53515625">Type</th><th width="328.79296875">Description</th><th>是否必需</th></tr></thead><tbody><tr><td>token</td><td>string</td><td>代币地址</td><td>是</td></tr><tr><td>is_include_180</td><td>bool</td><td>是否查询180天数据<br>- 若不查询，默认为 30 天内数据<br>- 数据量较大，查询稍慢</td><td>否</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "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
                }
            },
        ]
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段

其他返回值参考[上述文档](#fhz)

| Name          | Type | Description       |
| ------------- | ---- | ----------------- |
| token\_source | int  | 代币发行平台            |
| is\_encoded   | bool | trader 地址是否经过编码处理 |

### 查询工具额度消耗：1

## 查询代币盈利地址

<mark style="color:green;">`POST`</mark>  `/queryProfitTraderByToken`

\<Description of the endpoint>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th>Name</th><th>Type</th><th width="292.6796875">Description</th><th>是否必需</th></tr></thead><tbody><tr><td>token</td><td>string</td><td>代币地址</td><td>是</td></tr><tr><td>is_include_180</td><td>bool</td><td>是否查询180天数据<br>- 若不查询，默认为 30 天内数据<br>- 数据量较大，查询稍慢</td><td>否</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "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
                }
            },
        ]
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段

其他返回值参考[上述文档](#fhz)

| Name          | Type | Description       |
| ------------- | ---- | ----------------- |
| token\_source | int  | 代币发行平台            |
| is\_encoded   | bool | trader 地址是否经过编码处理 |

### 查询工具额度消耗：1

## 查询多代币共同盈利地址

<mark style="color:green;">`POST`</mark>  `/querySameProfitTraderByTokens`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th>Name</th><th>Type</th><th width="311.07421875">Description</th><th>是否必需</th></tr></thead><tbody><tr><td>tokens</td><td>[]string</td><td>代币地址，列表传入</td><td>是</td></tr><tr><td>is_include_180</td><td>bool</td><td>是否查询180天数据<br>- 若不查询，默认为 30 天内数据<br>- 数据量较大，查询稍慢</td><td>否</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段

| Name        | Type | Description       |
| ----------- | ---- | ----------------- |
| total\_pnl  | int  | 多个代币合计 pnl        |
| total\_cost | int  | 多个代币合计成本          |
| is\_encoded | bool | trader 地址是否经过编码处理 |
| balance     | int  | 地址 SOL 余额         |

### 额度消耗：1

## 查询多代币共同前排地址

<mark style="color:green;">`POST`</mark>  `/querySameEarlyTraderByTokens`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th>Name</th><th>Type</th><th width="304.69921875">Description</th><th>是否必需</th></tr></thead><tbody><tr><td>tokens</td><td>[]string</td><td>代币地址，列表传入</td><td>是</td></tr><tr><td>is_include_180</td><td>bool</td><td>是否查询180天数据<br>- 若不查询，默认为 30 天内数据<br>- 数据量较大，查询稍慢</td><td>否</td></tr><tr><td>token_age</td><td>int</td><td>代币创建后多久内买入，输入秒数</td><td>是</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段

| Name        | Type | Description       |
| ----------- | ---- | ----------------- |
| total\_pnl  | int  | 多个代币合计 pnl        |
| total\_cost | int  | 多个代币合计成本          |
| is\_encoded | bool | trader 地址是否经过编码处理 |
| balance     | int  | 地址 SOL 余额         |

### 查询工具额度消耗：1

## 查询剩余额度

<mark style="color:green;">`POST`</mark>  `/getUserCreditInfo`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

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

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "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
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "code": 400,
    "message": "error message"
}
```

{% endtab %}
{% endtabs %}

### 返回值字段

<table><thead><tr><th width="306.94921875">Name</th><th width="139.37890625">Type</th><th>Description</th></tr></thead><tbody><tr><td>query_trader_detail_credit_left</td><td>int</td><td>剩余 Trader 详细交易数据查询额度</td></tr><tr><td>query_trader_detail_credit_limit</td><td>int</td><td>总共 Trader 详细交易数据额度</td></tr><tr><td>query_tool_credit_left</td><td>int</td><td>剩余查询工具使用额度</td></tr><tr><td>query_tool_credit_limit</td><td>int</td><td>全部查询工具使用额度</td></tr><tr><td>credit_cycle_end_at</td><td>int</td><td>额度周期结束时间</td></tr></tbody></table>

### 额度消耗：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    |


---

# 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://docs.moneyscan.ai/moneyscan-api-docs.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.