持仓划转

发起内部持仓划转

value TradeClient::transfer_position(utility::string_t from_account, utility::string_t to_account, const value &transfers, utility::string_t market)

说明

该接口用于机构用户发起内部持仓划转。用户需已开通 OpenAPI 权限，并具有对转出账户执行头寸划转的权限。

参数

参数名	类型	是否必填	描述
from_account	utility::string_t	Yes	转出账户 ID
to_account	utility::string_t	Yes	转入账户 ID
transfers	const value &	Yes	持仓划转列表 JSON 数组
market	utility::string_t	No	市场，U("US")/U("HK")

web::json::value JSON 对象

示例

#include "tigerapi/trade_client.h"
#include "tigerapi/client_config.h"

using namespace TIGER_API;
using namespace web::json;

ClientConfig config(false, U("your_config_directory_path"));
TradeClient trade_client(config);

value transfers = value::array();
value item = value::object();
item[U("symbol")] = value::string(U("AAPL"));
item[U("quantity")] = value::number(100);
item[U("sec_type")] = value::string(U("STK"));
transfers[0] = item;

value result = trade_client.transfer_position(
    U("100001"), U("100002"), transfers, U("US"));
ucout << result.serialize() << std::endl;

获取内部持仓划转记录

value TradeClient::get_position_transfer_records(utility::string_t since_date, utility::string_t to_date, utility::string_t status, utility::string_t market, utility::string_t symbol, utility::string_t account_id)

说明

查询机构账户在指定时间范围内（不超过 90 天）的内部持仓划转记录

参数

参数名	类型	是否必填	描述
since_date	utility::string_t	No	开始日期，格式 YYYY-MM-DD
to_date	utility::string_t	No	结束日期，格式 YYYY-MM-DD
status	utility::string_t	No	状态过滤
market	utility::string_t	No	市场过滤
symbol	utility::string_t	No	标的代码过滤
account_id	utility::string_t	No	账户 ID

web::json::value JSON 对象

示例

ClientConfig config(false, U("your_config_directory_path"));
TradeClient trade_client(config);

value result = trade_client.get_position_transfer_records(
    U("2024-01-01"), U("2024-03-31"));
ucout << result.serialize() << std::endl;

获取内部持仓划转详情

value TradeClient::get_position_transfer_detail(utility::string_t transfer_id, utility::string_t account_id)

说明

查询指定划转记录的详情，包括每个标的的划转状态

参数

参数名	类型	是否必填	描述
transfer_id	utility::string_t	Yes	划转记录 ID
account_id	utility::string_t	No	转出账户 ID

web::json::value JSON 对象

示例

ClientConfig config(false, U("your_config_directory_path"));
TradeClient trade_client(config);

value result = trade_client.get_position_transfer_detail(U("123456789"));
ucout << result.serialize() << std::endl;

获取外部持仓划转记录

value TradeClient::get_position_transfer_external_records(utility::string_t since_date, utility::string_t to_date, utility::string_t status, utility::string_t market, utility::string_t symbol, utility::string_t account_id)

说明

查询机构账户在指定时间范围内（不超过 90 天）的外部划转记录，支持类型包括 DWAC、DRS、FOP 等

参数

参数名	类型	是否必填	描述
since_date	utility::string_t	No	开始日期，格式 YYYY-MM-DD
to_date	utility::string_t	No	结束日期，格式 YYYY-MM-DD
status	utility::string_t	No	状态过滤
market	utility::string_t	No	市场过滤
symbol	utility::string_t	No	标的代码过滤
account_id	utility::string_t	No	账户 ID

web::json::value JSON 对象

示例

ClientConfig config(false, U("your_config_directory_path"));
TradeClient trade_client(config);

value result = trade_client.get_position_transfer_external_records(
    U("2024-01-01"), U("2024-03-31"), U(""), U(""), U(""), U("100001"));
ucout << result.serialize() << std::endl;