# 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    |