> ## Documentation Index
> Fetch the complete documentation index at: https://chenyu.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 充值记录

> 查询充值记录列表

# 充值记录

查询账户的充值记录，支持分页查询。

## 请求参数

<ParamField query="page" type="string" optional>
  页码，从1开始
</ParamField>

<ParamField query="page_size" type="string" optional>
  每页数量
</ParamField>

<ParamField query="trade_number" type="string" optional>
  订单号，支持模糊搜索
</ParamField>

## 响应参数

<ResponseField name="code" type="integer">
  响应码
</ResponseField>

<ResponseField name="msg" type="string">
  响应信息
</ResponseField>

<ResponseField name="data" type="object">
  充值记录数据

  <Expandable title="data">
    <ResponseField name="recharge_list" type="array">
      充值记录列表

      <Expandable title="recharge_list">
        <ResponseField name="amount" type="number">
          充值金额
        </ResponseField>

        <ResponseField name="trade_time" type="integer">
          订单产生时间，秒级时间戳
        </ResponseField>

        <ResponseField name="pay_time" type="integer">
          支付时间，秒级时间戳
        </ResponseField>

        <ResponseField name="trade_number" type="string">
          交易编号
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="integer">
      总记录数
    </ResponseField>
  </Expandable>
</ResponseField>

## 代码示例

<CodeGroup>
  ```python Python theme={null}
  import requests

  url = "https://www.chenyu.cn/api/open/v2/recharge/list"
  headers = {
      "Authorization": "Bearer your_api_key"
  }

  params = {
      "page": "1",
      "page_size": "10",
      "trade_number": "TXN123456789"  # 可选，按订单号筛选
  }

  response = requests.get(url, headers=headers, params=params)
  result = response.json()

  if result['code'] == 0:
      recharge_data = result['data']
      print(f"总记录数: {recharge_data['total']}")
      
      for record in recharge_data['recharge_list']:
          print(f"充值金额: {record['amount']}")
          print(f"交易编号: {record['trade_number']}")
          print(f"订单时间: {record['trade_time']}")
          print(f"支付时间: {record['pay_time']}")
          print("---")
  else:
      print(f"查询失败: {result['msg']}")
  ```

  ```javascript JavaScript theme={null}
  const axios = require('axios');

  const url = 'https://www.chenyu.cn/api/open/v2/recharge/list';
  const headers = {
      'Authorization': 'Bearer your_api_key'
  };

  const params = {
      page: "1",
      page_size: "10",
      trade_number: "TXN123456789"  // 可选，按订单号筛选
  };

  axios.get(url, { headers, params })
      .then(response => {
          const result = response.data;
          
          if (result.code === 0) {
              const rechargeData = result.data;
              console.log(`总记录数: ${rechargeData.total}`);
              
              rechargeData.recharge_list.forEach(record => {
                  console.log(`充值金额: ${record.amount}`);
                  console.log(`交易编号: ${record.trade_number}`);
                  console.log(`订单时间: ${record.trade_time}`);
                  console.log(`支付时间: ${record.pay_time}`);
                  console.log('---');
              });
          } else {
              console.log(`查询失败: ${result.msg}`);
          }
      })
      .catch(error => {
          console.error('Error:', error.response.data);
      });
  ```

  ```curl cURL theme={null}
  curl -X GET "https://www.chenyu.cn/api/open/v2/recharge/list?page=1&page_size=10&trade_number=TXN123456789" \
    -H "Authorization: Bearer your_api_key"
  ```
</CodeGroup>

## 响应示例

<CodeGroup>
  ```json 成功响应 theme={null}
  {
    "code": 0,
    "msg": "查询成功",
    "data": {
      "recharge_list": [
        {
          "amount": 500.00,
          "trade_time": 1705294225,
          "pay_time": 1705294270,
          "trade_number": "TXN20240115103025001"
        },
        {
          "amount": 1000.00,
          "trade_time": 1704870015,
          "pay_time": 1704870065,
          "trade_number": "TXN20240110152015002"
        }
      ],
      "total": 25
    }
  }
  ```

  ```json 失败响应 theme={null}
  {
    "code": -1,
    "msg": "查询失败"
  }
  ```
</CodeGroup>
