| Xlight API用户手册 v1.5.1.2 Xlight极速柜台接口文档

载入中...
搜索中...
未找到
结构体 | 类型定义 | 枚举 | 变量
xlt_data_type.h 文件参考

本文件定义XLT API中使用的基本数据类型和常量 更多...

`#include <cstdint>`
`#include <climits>`

## 结构体
struct | xlt_error_info_t
| 错误信息 更多...
struct | xlt_order_query_param_t
| 订单查询请求-条件查询 更多...
struct | xlt_query_by_page_param_t
| 分页查询请求参数 更多...

## 类型定义
typedef int64_t | amount_t
| 金额 类型
typedef int64_t | price_t
| 价格 类型
typedef int64_t | quantity_t
| 数量 类型
typedef struct x1::xlt_query_by_page_param_t | xlt_query_by_page_param_t
| 分页查询请求参数

## 枚举
enum class | ApiLogLevel : uint8_t { LOG_FATAL = 0 , LOG_ERROR = 1 , LOG_WARN = 2 , LOG_INFO = 3 , LOG_DEBUG = 4 , LOG_TRACE = 5 }
| API日志级别 更多...
enum class | TradeResumeType : uint8_t { RESTART = 1 , QUICK = 2 , SPECIFY = 3 , NONE = 99 }
| 交易消息推送类型 更多...
enum class | ExchangeIndex : uint8_t { INIT = 0 , SH = 1 , SZ = 2 }
| 交易所编号定义 更多...
enum class | OrderType : uint8_t { NONE = 0 , BEST_FIVE_PRICE_OR_CANCEL = 1 , LIMIT_PRICE = 2 , BEST_FIVE_PRICE_TO_LIMIT = 3 , SELF_BEST = 4 , COUNTER_BEST = 5 , MARKET_PRICE_OR_CANCEL = 6 , MARKET_PRICE_ALL_OR_CANCEL = 7 }
| 报单价格类型 更多...
enum class | Side : uint8_t { BUY = 1 , SELL = 2 }
| 买卖方向 更多...
enum class | BusinessType : uint8_t { NONE = 0 , CASH = 1 , BOND_MATCH = 2 , ETF = 3 , ISSUE = 4 , ALLOT = 5 , BOND_CONVERT = 6 , PLEDGE_STYLE_REPO = 7 }
| 业务类型 更多...
enum class | OrderBriefStatus : uint8_t { INIT = 1 , SUBMITTED = 2 , FINISHED = 3 }
| 订单简要状态，API订单状态通知使用 更多...
enum class | OrderStatus : uint8_t { INIT = 0 , ALL_TRADED = 1 , PART_TRADED = 2 , PART_CANCELED = 3 , NOT_TRADED = 4 , ALL_CANCELED = 5 , REJECTED = 6 , COUNT = 7 }
| 订单状态 更多...
enum class | PositionSecurityType : uint8_t { NORMAL = 0 , PLACEMENT = 1 , UNKNOWN = 99 }
| 持仓证券类型 更多...
enum class | QuoteSecurityType : uint8_t { STOCK = 1 , FUND = 2 , BOND = 3 , OPTION = 4 , INDEX = 5 , UNKNOWN = 99 }
| 证券类型 更多...
enum class | QualificationType : uint8_t { PUBLIC = 1 , COMMON = 2 , ORGANIZATION = 3 , UNKNOWN = 99 }
| 证券适当性枚举类型 更多...
enum class | QuoteDataLevel : uint8_t { LEVEL_ALL = 0 , LEVEL_1 = 1 , LEVEL_2 = 2 }
| 行情级别：Level1/Level2 更多...

## 变量
constexpr uint8_t | CONST_STR_SECURITY_CODE_LEN = 9
| 证券代码长度，含字符串终止符
constexpr uint16_t | CONST_ERROR_MSG_LEN = 256
| 错误信息长度
constexpr uint8_t | CONST_SECURITY_NAME_LEN = 33
| 证券名称长度
constexpr uint8_t | CONST_CL_ORD_ID_LEN = 11
| 委托合同号长度，含字符串终止符
constexpr uint8_t | CONST_REPORT_ID_LEN = 32
| 委托回报ID长度
constexpr uint8_t | CONST_ACC_NAME_LEN = 64 + 1
| 账户名称长度
constexpr uint8_t | CONST_ACC_PASSWD_LEN = 128 + 1
| 账户密码长度
constexpr uint16_t | CONST_TERMINAL_INFO_LEN = 256 + 1
| 终端信息的字符串长度
constexpr uint8_t | CONST_API_VERSION_STR_LEN = 24 + 1
| API 版本信息字符串长度
constexpr uint64_t | PAGE_REQ_COUNT_MIN = 1
| 分页请求最小数量
constexpr uint16_t | CONST_TRD_EXEC_ID_LEN = 16 + 1
| 成交编号长度，含字符串终止符
constexpr uint8_t | CONST_FUND_ACC_NAME_LEN = 15
| 资金账户名称长度

## 详细描述

本文件定义XLT API中使用的基本数据类型和常量

作者
  上海前路有光数字科技

日期
  2026-01-10

## 枚举类型说明

## ◆ ApiLogLevel

enum class ApiLogLevel : uint8_t
| strong

API日志级别

枚举值
LOG_FATAL | fatal级别
LOG_ERROR | error级别
LOG_WARN | warn级别
LOG_INFO | info级别
LOG_DEBUG | debug级别
LOG_TRACE | trace级别

## ◆ BusinessType

enum class BusinessType : uint8_t
| strong

业务类型

枚举值
NONE | 未知类型
CASH | 现货（股票、基金、深圳可转债等）集中竞价交易
BOND_MATCH | 债券现券竞价交易
ETF | ETF申赎业务
ISSUE | 网上发行业务
ALLOT | 配售业务
BOND_CONVERT | 债转股业务
PLEDGE_STYLE_REPO | 债券质押式回购

## ◆ ExchangeIndex

enum class ExchangeIndex : uint8_t
| strong

交易所编号定义

枚举值
INIT | 初始化值或者未知
SH | 上海证券交易所。
SZ | 深圳证券交易所。

## ◆ OrderBriefStatus

enum class OrderBriefStatus : uint8_t
| strong

订单简要状态，API订单状态通知使用

枚举值
INIT | 初始。
SUBMITTED | 已报。
FINISHED | 结束。

## ◆ OrderStatus

enum class OrderStatus : uint8_t
| strong

订单状态

枚举值
INIT | 初始。
ALL_TRADED | 全部成交。
PART_TRADED | 部分成交。
PART_CANCELED | 部分撤单。
NOT_TRADED | 未成交。
ALL_CANCELED | 全部撤单/已撤单。
REJECTED | 废单。
COUNT | 委托状态数量。

## ◆ OrderType

enum class OrderType : uint8_t
| strong

报单价格类型

枚举值
NONE | 无特定类型。
BEST_FIVE_PRICE_OR_CANCEL | 市转撤（市价最优五档全额成交剩余撤销）。
LIMIT_PRICE | 限价。
BEST_FIVE_PRICE_TO_LIMIT | 市转限（市价最优五档全额成交剩余转限价）（仅上海有效）。
SELF_BEST | 本方最优。
COUNTER_BEST | 对手方最优。
MARKET_PRICE_OR_CANCEL | 市价立即成交剩余撤销（仅深圳有效）。
MARKET_PRICE_ALL_OR_CANCEL | 市价全额成交或撤销（仅深圳有效）。

## ◆ PositionSecurityType

enum class PositionSecurityType : uint8_t
| strong

持仓证券类型

枚举值
NORMAL | 普通持仓
PLACEMENT | 配售类型的持仓，包含配股、配债等
UNKNOWN | 未知类型

## ◆ QualificationType

enum class QualificationType : uint8_t
| strong

证券适当性枚举类型

枚举值
PUBLIC | 包括普通投资者、专业投资者 在内的所有投资者
COMMON | 仅专业投资者
ORGANIZATION | 仅专业投资者中的机构投资者
UNKNOWN | 其他

## ◆ QuoteDataLevel

enum class QuoteDataLevel : uint8_t
| strong

行情级别：Level1/Level2

枚举值
LEVEL_ALL | Level1和Level2
LEVEL_1 | Level1
LEVEL_2 | Level2

## ◆ QuoteSecurityType

enum class QuoteSecurityType : uint8_t
| strong

证券类型

枚举值
STOCK | 股票
FUND | 基金
BOND | 债券
OPTION | 期权
INDEX | 指数
UNKNOWN | 未知类型

## ◆ Side

enum class Side : uint8_t
| strong

买卖方向

枚举值
BUY | 买入(ETF申购)。
SELL | 卖出(ETF赎回)。

## ◆ TradeResumeType

enum class TradeResumeType : uint8_t
| strong

交易消息推送类型

枚举值
RESTART | 从本交易日日初开始推送
QUICK | 从最新数据开始推送
SPECIFY | 从指定sequence开始推送
NONE | 不推送交易消息