跳到主要内容

账户流水 (Income History)

想查订单历史?

本接口返回的是流水记录(损益、资金费、手续费),不是订单。 查询真正的订单历史请见 查询所有订单 — GET /fapi/v1/allOrders。

接口描述​

查询账户损益、资金费、手续费等流水。

HTTP请求​

GET /fapi/v1/income (HMAC SHA256)

请求参数​

名称类型是否必需描述
symbolSTRINGNO交易对。仅对 REALIZED_PNL 和 FUNDING_FEE 记录生效;COMMISSION 记录不按 symbol 过滤。
incomeTypeENUMNO流水类型: REALIZED_PNL、FUNDING_FEE 或 COMMISSION。传其他任何值均返回空数组。
startTimeLONGNO起始时间。仅对 COMMISSION 记录生效。
endTimeLONGNO结束时间。仅对 COMMISSION 记录生效。
limitINTNO默认 100; 最大 1000
timestampLONGYES时间戳

响应示例​

[
  {
    "symbol": "BTCUSDT",
    "incomeType": "FUNDING_FEE",      // 流水类型
    "income": "-0.01000000",         // 金额
    "asset": "USDT",                 // 资产
    "info": "5841022",               // 详情字段
    "time": 1570636800000,           // 时间戳
    "tranId": "96893222",            // 内部交易 ID
    "tradeId": "5000"                // 成交 ID
  }
]

如果不发送 symbol，则会返回所有交易对的流水。

代码示例​

curl​

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="limit=10&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY_STRING}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')
curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.prex.world/fapi/v1/income?${QUERY_STRING}&signature=${SIGNATURE}"

Python​

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.prex.world"

timestamp = int(time.time() * 1000)
qs = f"limit=10&timestamp={timestamp}"
sig = hmac.new(API_SECRET.encode(), qs.encode(), hashlib.sha256).hexdigest()
response = requests.get(
    f"{BASE_URL}/fapi/v1/income",
    params={"limit": 10, "timestamp": timestamp, "signature": sig},
    headers={"X-MBX-APIKEY": API_KEY}
)
for item in response.json():
    print(f"{item['incomeType']}: {item['income']} {item['asset']} ({item['symbol']})")