跳轉到內容

獲取資金流水

該接口用於獲取資金流入/流出方向、資金類別、資金金額、發生時間、關聯股票代碼和資金流水說明信息。

Request

HTTP MethodGET
HTTP URL/v1/asset/cashflow

Parameters

Content-Type: application/json; charset=utf-8

NameTypeRequiredDescription
start_timestringYES开始时间,时间戳,以 为单位,例如:1650037563
end_timestringYES结束时间,时间戳,以 为单位,例如:1650747581
business_typestringNO资金类型

可选值:
1 - 现金
2 - 股票
3 - 基金
symbolstringNO标的代码,例如:AAPL.US
pagestringNO起始页

默认值: 1
数据校验规则:
取值范围: >=1
sizestringNO每页大小

默认值: 50
数据校验规则: 1~10000

Request Example

python
# 獲取資金流水
# https://open.longportapp.com/docs/trade/asset/cashflow
from datetime import datetime
from longport.openapi import TradeContext, Config

config = Config.from_env()
ctx = TradeContext(config)
resp = ctx.cash_flow(
    start_at = datetime(2022, 5, 9),
    end_at = datetime(2022, 5, 12),
)
print(resp)

Response

Response Headers

  • Content-Type: application/json

Response Example

json
{
  "code": 0,
  "data": {
    "list": [
      {
        "transaction_flow_name": "股票買入成交",
        "direction": 1,
        "balance": "-248.60",
        "currency": "USD",
        "business_time": "1621507957",
        "symbol": "AAPL.US",
        "description": "AAPL"
      },
      {
        "transaction_flow_name": "股票買入成交",
        "direction": 1,
        "balance": "-125.16",
        "currency": "USD",
        "business_time": "1621504824",
        "symbol": "AAPL.US",
        "description": "AAPL"
      }
    ]
  }
}

Response Status

StatusDescriptionSchema
200返回成功cashflow_rsp
400內部錯誤None

Schemas

cashflow_rsp

NameTypeRequiredDescription
listobject[]false流水信息
∟ transaction_flow_namestringtrue流水名稱
∟ directionstringtrue流出方向

可選值:
1 - 流出
2 - 流入
∟ business_typestringtrue资金类别

可選值:
1 - 現金
2 - 股票
3 - 基金
∟ balancestringtrue資金金額
∟ currencystringtrue資金幣種
∟ business_timestringtrue業務時間
∟ symbolstringfalse關聯股票代碼信息
∟ descriptionstringfalse資金流水說明