How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

XT.COM 合约信息 API

Contract Info Controller

XT.COM 合约信息 API is one of 9 APIs that XT.COM publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 12 JSON Schema definitions.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 12 JSON Schemas.

This API exposes 112 operations across 108 paths, and defines 133 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://fapi.xt.com.

112 operations 108 paths 133 schemas 89 GET23 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://fapi.xt.com/future/market
License
Terms of Service
Resource Areas
1

Paths & Operations 112

Across 108 paths, the API surfaces 112 operations — 89 GET, 23 POST. Each is listed below with its method, path, parameters, and response codes.

合约信息 112

Contract Info Controller

GET
/v1/public/contract/open-interest
获取交易对仓位头寸
getOpenInterestUsingGET 2 params → 200401403404
GET
/v1/public/contract/risk-balance
获取交易对风险基金余额
getRiskBalanceListUsingGET 5 params → 200401403404
GET
/v1/public/cg/contracts
获取合约信息
getContractsUsingGET 1 param → 200401403404
GET
/v1/public/cg/orderbook
获取交易对的深度信息
getDepthUsingGET 3 params → 200401403404
GET
/v1/public/market/category
获取异动分类
categoryUsingGET → 200401403404
GET
/v1/public/market/list
获取市场异动列表
listUsingGET 3 params → 200401403404
GET
/v1/public/time
获取服务器时间
getServerTimeUsingGET → 200401403404
GET
/v1/public/leverage/bracket/detail
查询单个交易对杠杆分层
getBracketDetailUsingGET 1 param → 200401403404
GET
/v1/public/leverage/bracket/list
查询所有交易对杠杆分层
getBracketListUsingGET_1 → 200401403404
GET
/v1/public/event-future/limit
获取事件合约限制信息
getEventFutureLimitUsingGET → 200401403404
GET
/v1/public/event-future/list/detail
获取所事件合约配置信息
getEventFutureListUsingGET → 200401403404
GET
/v1/public/symbol/all
获取所有交易对
getAllSymbolsUsingGET 1 param → 200401403404
GET
/v1/public/symbol/coin/detail
获取币种详情
getCoinDetailUsingGET 1 param → 200401403404
GET
/v1/public/symbol/coins
获取交易对币种
getCoinListUsingGET → 200401403404
GET
/v1/public/symbol/detail
获取单个交易对的配置信息
getSymbolDetailUsingGET 2 params → 200401403404
GET
/v1/public/symbol/list
获取所有交易对的配置信息
getSymbolListUsingGET_3 1 param → 200401403404
GET
/v1/public/plate/list
获取板块信息
getSymbolListUsingGET_2 1 param → 200401403404
GET
/v1/merchant/q/trade-list
查询成交明细
getTradeListUsingGET 6 params → 200401403404
GET
/v1/public/q/agg-ticker
获取指定交易对的聚合行情信息
getAggTickerUsingGET 2 params → 200401403404
GET
/v1/public/q/agg-tickers
获取全交易对的聚合行情信息
getAggTickersUsingGET 1 param → 200401403404
GET
/v1/public/q/deal
获取交易对的最新成交信息
getDealsUsingGET_1 3 params → 200401403404
GET
/v1/public/q/deliver-kline
获取交割合约的k线信息
getDeliverKlineUsingGET 6 params → 200401403404
GET
/v1/public/q/depth
获取交易对的深度信息
getDepthUsingGET_3 3 params → 200401403404
GET
/v1/public/q/funding-rate
获取资金费率
getFundingRateUsingGET_1 2 params → 200401403404
GET
/v1/public/q/funding-rate-record
获取资金费率记录
getFundingRateRecordUsingGET_1 5 params → 200401403404
GET
/v1/public/q/funding-rate-record-chart
获取资金费率图表
getFundingRateRecordChartUsingGET 4 params → 200401403404
GET
/v1/public/q/funding-rate-record-tool
获取资金费率工具记录
getFundingRateToolRecordUsingGET 5 params → 200401403404
GET
/v1/public/q/funding-rate-tool
获取资金费率工具
getFundingRateToolUsingGET 2 params → 200401403404
GET
/v1/public/q/index-price
获取所有交易对的指数价格
getAllIndexPriceUsingGET 2 params → 200401403404
GET
/v1/public/q/index-price/list
获取指定交易对的指数价格
findIndexPriceListUsingGET 5 params → 200401403404
GET
/v1/public/q/indicator
获取k线指标
getIndicatorUsingGET 5 params → 200401403404
GET
/v1/public/q/kline
获取交易对的k线信息
getKlineUsingGET_1 6 params → 200401403404
GET
/v1/public/q/mark-price
获取所有交易对的标记价格
getAllMarkPriceUsingGET 2 params → 200401403404
GET
/v1/public/q/openprice
获取交易对指定时区当天0点的开盘时间,不传symbol获取所有可交货币对
getOpenPriceUsingGET 2 params → 200401403404
GET
/v1/public/q/symbol-index-price
获取单个交易对的指数价格
getIndexPriceBySymbolUsingGET_1 2 params → 200401403404
GET
/v1/public/q/symbol-mark-price
获取单个交易对的标记价格
getMarkPriceBySymbolUsingGET_1 2 params → 200401403404
GET
/v1/public/q/ticker
获取指定交易对的行情信息
getTickerUsingGET_1 2 params → 200401403404
GET
/v1/public/q/ticker/book
获取指定交易对的买一卖一行情信息
getTickerBookUsingGET_1 2 params → 200401403404
GET
/v1/public/q/ticker/books
获取全交易对的买一卖一行情信息
getTickerBooksUsingGET 1 param → 200401403404
GET
/v1/public/q/tickers
获取全交易对的行情信息
getTickersUsingGET 1 param → 200401403404
GET
/v1/public/q/tradestats
获取统计信息
getTradeStatsUsingGET → 200401403404
GET
/v1/share/template
获取分享文案模版
getTemplateUsingGET → 200401403404
GET
/v1/notice/has-view-notice/{type}
是否已阅读风险告知书
isReadNoticeUsingGET 1 param → 200401403404
POST
/v1/notice/view-notice/{type}
阅读风险告知书
readNoticeUsingPOST 1 param → 200201401403404
POST
/v1/smartMoney/dealSubAccount
加入子账号、移除子账号
dealSubAccountUsingPOST 2 params → 200201401403404
GET
/v1/smartMoney/getDesc
查询描述
getDescUsingGET 1 param → 200401403404
GET
/v1/smartMoney/getSmartMoneySubAccounts
查询子账号列表
getSmartMoneySubAccountsUsingGET → 200401403404
POST
/v1/smartMoney/notify/update
开、关推送接口
updateNotifyUsingPOST 2 params → 200201401403404
GET
/v1/smartMoney/public/getTraderAmount
查询累计收益&资产
getTraderAmountUsingGET 3 params → 200401403404
GET
/v1/smartMoney/public/getTraderInfo
查询绩效分析【交易数据】
getTraderUsingGET 3 params → 200401403404
GET
/v1/smartMoney/public/list
分页查询顶级交易员
topTradersUsingGET 4 params → 200401403404
GET
/v1/smartMoney/public/user-mark
掩码处理接口
getMarkUsingGET 1 param → 200401403404
GET
/v1/smartMoney/self/getTraderAmount
查询累计收益&资产【用于我的主页】
getTraderAmountForSelfUsingGET 2 params → 200401403404
GET
/v1/smartMoney/self/traderInfo
我的主页,主账号可以看子账号,子账号只能看自身。
getTraderForSelfUsingGET 2 params → 200401403404
GET
/v1/smartMoney/selfList
查询我的订阅【查询开关状态、订阅状态的接口】
topTradersForSelfUsingGET 4 params → 200401403404
POST
/v1/smartMoney/sub/update
订阅&取消订阅
updateSubUsingPOST 2 params → 200201401403404
POST
/v1/smartMoney/updateDesc
更新描述
updateDescUsingPOST body → 200201401403404
POST
/v1/smartMoney/updateSharePosition
分享我的仓位开关
updateSharePositionUsingPOST 2 params → 200201401403404
POST
/v1/smartMoney/updateTradingSet
实盘设置开启、关闭
updateTradingSetUsingPOST 2 params → 200201401403404
GET
/v1/compat/account/is-open/{subAccountId}
校验子账号是否开通合约
isOpenUsingGET 1 param → 200401403404
GET
/v1/compat/account/open
是否已经开通合约
getUserOpenStatusUsingGET → 200401403404
GET
/v1/compat/balance/convert
资产总计转化
getBalanceConvertUsingGET → 200401403404
GET
/v1/compat/balance/list
资产列表
getBalanceUsingGET_1 1 param → 200401403404
GET
/v1/compat/balance/{coin}
单币种资产
getBalanceByCoinUsingGET_1 2 params → 200401403404
GET
/v1/public/compat/coins
划转币种列表
getTransferCoinsUsingGET → 200401403404
GET
/v1/taker-over/list
查询接管记录
getListUsingGET 7 params → 200401403404
POST
/v1/apply-trader
申请跟单操盘手
applyUsingPOST 7 params → 200201401403404
GET
/v1/leverage/bracket/detail
查询单个交易对杠杆分层
getV1LeverageBracketDetail 1 param → 200401403404
GET
/v1/leverage/bracket/list
查询所有交易对杠杆分层
getBracketListUsingGET → 200401403404
POST
/v1/account/agreement/agree-predict
同意预测合约协议
agreePredictAgreementUsingPOST → 200201401403404
GET
/v1/account/agreement/is-open-predict
查询预测合约协议是否开通
isOpenPredictUsingGET → 200401403404
GET
/v1/account/info
获取账户相关信息
getAccountUsingGET → 200401403404
POST
/v1/account/open
开通合约
openFuturesUsingPOST 1 param → 200201401403404
GET
/v1/account/region
检查开通合约地区
checkRegionUsingGET → 200401403404
GET
/v1/user/satisfaction-feedback
获取反馈
checkUsingGET → 200401403404
POST
/v1/user/satisfaction-feedback
提交反馈
submitUsingPOST 4 params → 200201401403404
GET
/v1/user/satisfaction-feedback/feedbacks
反馈功能标签列表
getFeedbacksUsingGET → 200401403404
GET
/v1/welfare/bonus-detail-list
体验金详情
bonusListUsingGET 5 params → 200401403404
GET
/v1/welfare/deposit-coupon-detail-list
储值券详情
depositCouponListUsingGET 5 params → 200401403404
GET
/v1/welfare/future-coupon
合约可用赠金券
getWelfareCouponUsingGET 1 param → 200401403404
GET
/v1/auto-deleverage/history
获取自动减仓历史
getAutoDeleverageHistoryUsingGET 7 params → 200401403404
GET
/v1/user/setting/notify/funding-rate-clearing
查询资金费率提醒开关是否开启
getFundRateClearingNotificationUsingGET → 200401403404
POST
/v1/user/setting/notify/funding-rate-clearing
设置资金费率提醒开关
updateFundRateClearingNotificationUsingPOST 1 param → 200201401403404
GET
/v1/user/setting/notify/order-execution
查询合约订单成交提醒开关是否开启
getOrderExecutionNotificationUsingGET → 200401403404
POST
/v1/user/setting/notify/order-execution
设置合约订单成交提醒开关
updateOrderExecutionNotificationUsingPOST 1 param → 200201401403404
GET
/v1/user/setting/notify/profit-trigger
止盈止损提醒开关是否开启
getProfitTriggerUsingGET → 200401403404
POST
/v1/user/setting/notify/profit-trigger/update
设置止盈止损提醒开关
updateProfitTriggerUsingPOST 1 param → 200201401403404
GET
/v1/user/setting/price-protection
查询止盈止损价差保护开关是否开启
getPriceProtectionUsingGET → 200401403404
POST
/v1/user/setting/price-protection
设置止盈止损价差保护开关
updatePriceProtectionUsingPOST 1 param → 200201401403404
GET
/v1/balance/bills
获取用户账务流水
getBalanceBillsUsingGET 8 params → 200401403404
GET
/v1/balance/coupon/record
获取抵扣金记录
getCouponRecordUsingGET 3 params → 200401403404
GET
/v1/balance/detail
获取用户单币种资金
getBalanceByCoinUsingGET 1 param → 200401403404
POST
/v1/balance/fund/transfer
资金划转(合约子账户间划转)
exchangeUsingPOST 7 params → 200201401403404
GET
/v1/balance/funding-rate-list
获取资金费用
getFundingListUsingGET 12 params → 200401403404
GET
/v1/balance/list
获取用户资金
getBalanceUsingGET → 200401403404
GET
/v1/public/user/step-rate/getOtherPlatforms
获取第三方平台(无需登录)
getPublicOtherPlatformsUsingGET → 200401403404
GET
/v1/public/user/step-rate/getStepRates
获取用户费率表(无需登录)
getPublicStepRatesUsingGET → 200401403404
GET
/v1/user/step-rate
获取用户阶梯费率(对外)
getUserStepRate2UsingGET_1 → 200401403404
GET
/v1/user/step-rate/getOtherPlatforms
获取第三方平台
getOtherPlatformsUsingGET → 200401403404
GET
/v1/user/step-rate/getStepRates
获取用户费率表
getStepRatesUsingGET → 200401403404
GET
/v1/user/step-rate/getUserStepApplyResult
获取用户申请临时等级结果
getUserStepApplyResultUsingGET → 200401403404
GET
/v1/user/step-rate/getUserStepRatedeprecated
获取用户阶梯费率
getUserStepRateUsingGET → 200401403404
GET
/v1/user/step-rate/recent-trade
查询用户近30日交易量
findRecentTradeUsingGET 2 params → 200401403404
POST
/v1/user/step-rate/upload
上传图片
uploadUsingPOST body → 200201401403404
POST
/v1/user/step-rate/userStepApply
用户阶梯费率申请
userStepApplyUsingPOST body → 200201401403404
POST
/v1/user/collection/adddeprecated
收藏交易对(废弃)
collectSymbolUsingPOST body → 200201401403404
POST
/v1/user/collection/canceldeprecated
取消收藏交易对(废弃)
cancelCollectSymbolUsingPOST body → 200201401403404
GET
/v1/user/collection/list
自选交易对列表
getCollectionListUsingGET → 200401403404
POST
/v1/user/collection/update
更新自选交易对
updateCollectionSymbolsUsingPOST body → 200201401403404
GET
/v1/common/download-private/{key}
私有目录,下载图片
downLoadFromPrivateUsingGET 2 params → 200401403404
POST
/v1/common/upload-private
上传图片,私有目录
uploadPrivateUsingPOST 1 param body → 200201401403404
POST
/v1/common/upload-public
上传图片,公共目录
uploadPublicUsingPOST 1 param body → 200201401403404

Schemas 133

The contract defines 133 schemas that model the data the API accepts and returns. The most detailed are SymbolCacheDTO (73 properties), TopTraderInfoVO (28 properties), TraderInfoSelfVO (28 properties), ContractVO (25 properties). Each schema is shown below with its type and property counts.

OpenInterestVO
object
4 properties
CommonResponse_OpenInterestVO
object
4 properties
CommonResponse_MongoPageResult_RiskBalanceVO
object
4 properties
MongoPageResult_RiskBalanceVO
object
3 properties
ErrorMessage
object
3 properties
RiskBalanceVO
object
4 properties
ContractVO
object
25 properties
OrderBookVO
object
4 properties
MarketVO
object
7 properties
MarketCategoryVO
object
2 properties
PageResult_MarketVO
object
4 properties
CommonResponse_List_MarketCategoryVO
object
4 properties
CommonResponse_PageResult_MarketVO
object
4 properties
CommonResponse_long
object
4 properties
LeverageBracketCacheDTO
object
8 properties
CommonResponse_List_SymbolBracketCacheDTO
object
4 properties
CommonResponse_SymbolBracketVO
object
4 properties
SymbolBracketVO
object
2 properties
SymbolBracketCacheDTO
object
2 properties
EventFutureConfigVO
object
7 properties
CommonResponse_List_EventFutureConfigVO
object
4 properties
CommonResponse_EventFutureLimitInfoVO
object
4 properties
EventFutureLimitInfoVO
object
2 properties
CoinDetailVO
object
4 properties
CommonResponse_List_string
object
4 properties
CommonResponse_List_SymbolCacheDTO
object
4 properties
CommonResponse_List_CoinDetailVO
object
4 properties
SymbolCacheDTO
object
73 properties
CommonResponse_SymbolCacheDTO
object
4 properties
PlateVO
object
3 properties
CommonResponse_List_PlateVO
object
4 properties
CommonResponse_PageResult_MMTradeVO
object
4 properties
CommonResponse_DepthVO
object
4 properties
CommonResponse_List_TickerBookVO
object
4 properties
CommonResponse_FundRateDTO
object
4 properties
CommonResponse_TickerVO
object
4 properties
CommonResponse_List_DealVO
object
4 properties
KlineDTO
object
9 properties
CommonResponse_List_PriceVO
object
4 properties
TradeStatsVO
object
3 properties
CommonResponse_string
object
4 properties
CommonResponse_List_TickerVO
object
4 properties
TickerVO
object
9 properties
CommonResponse_TradeStatsVO
object
4 properties
FundRateDTO
object
4 properties
CommonResponse_MongoPageResult_FundRateRecordVO
object
4 properties
TickerBookVO
object
6 properties
CommonResponse_List_FundRateRecordVO
object
4 properties
DealVO
object
5 properties
PriceVO
object
3 properties
CommonResponse_TickerBookVO
object
4 properties
IndexPriceDTO
object
3 properties
AggTickerVO
object
13 properties
CommonResponse_List_IndexPriceDTO
object
4 properties
CommonResponse_List_KlineDTO
object
4 properties
DepthVO
object
5 properties
OpenPriceVO
object
2 properties
CommonResponse_List_OpenPriceVO
object
4 properties
CommonResponse_List_AggTickerVO
object
4 properties
CommonResponse_PriceVO
object
4 properties
CommonResponse_AggTickerVO
object
4 properties
MongoPageResult_FundRateRecordVO
object
3 properties
FundRateRecordVO
object
5 properties
PageResult_MMTradeVO
object
4 properties
MMTradeVO
object
12 properties
CommonResponse_List_ShareTemplateVO
object
4 properties
ShareTemplateVO
object
4 properties
CommonResponse_boolean
object
4 properties
AmountDTO
object
2 properties
PageResult_TopTraderVO
object
4 properties
CommonResponse_TraderInfoSelfVO
object
4 properties
CommonResponse_List_SmartMoneySubAccountVO
object
4 properties
CommonResponse_TopTraderInfoVO
object
4 properties
TopTraderInfoVO
object
28 properties
SmartMoneySubAccountVO
object
6 properties
TraderInfoSelfVO
object
28 properties
TopTraderCumulativeVO
object
6 properties
Component
object
2 properties 1 required
TopTraderVO
object
18 properties
CommonResponse_PageResult_TopTraderVO
object
4 properties
CommonResponse_TopTraderCumulativeVO
object
4 properties
CompatResponseDTO_List_AccountFunVO
object
4 properties
CompatResponseDTO_AccountFunVO
object
4 properties
CompatResponseDTO_BalanceConvertVO
object
4 properties
AccountFunVO
object
19 properties
CompatResponseDTO_List_string
object
4 properties
BalanceConvertVO
object
3 properties
CompatResponseDTO_boolean
object
4 properties
TakerOverVO
object
9 properties
MongoPageResult_TakerOverVO
object
3 properties
CommonResponse_MongoPageResult_TakerOverVO
object
4 properties
CommonResponse_AccountInfoVO
object
4 properties
AccountInfoVO
object
8 properties
SatisfactionFeedbackTypeDTO
object
2 properties
CommonResponse_List_SatisfactionFeedbackTypeDTO
object
4 properties
WelfareCouponSymbol
object
2 properties
CommonResponse_MongoPageResult_DepositCouponDetailVO
object
4 properties
MongoPageResult_BonusDetailVO
object
3 properties
CommonResponse_List_WelfareCoupon
object
4 properties
CommonResponse_MongoPageResult_BonusDetailVO
object
4 properties
BonusDetailVO
object
11 properties
DepositCouponDetailVO
object
7 properties
WelfareCoupon
object
11 properties
MongoPageResult_DepositCouponDetailVO
object
3 properties
AutoDeleverageHistoryVO
object
8 properties
MongoPageResult_AutoDeleverageHistoryVO
object
3 properties
CommonResponse_MongoPageResult_AutoDeleverageHistoryVO
object
4 properties
MongoPageResult_FundRateRecordDetailVO
object
3 properties
CommonResponse_BalanceVO
object
4 properties
CommonResponse_MongoPageResult_FundRateRecordDetailVO
object
4 properties
FundRateRecordDetailVO
object
6 properties
BalanceVO
object
11 properties
PageResult_CouponRecordVO
object
4 properties
CommonResponse_MongoPageResult_BalanceBillVO
object
4 properties
CommonResponse_object
object
4 properties
MongoPageResult_BalanceBillVO
object
3 properties
CommonResponse_PageResult_CouponRecordVO
object
4 properties
BalanceBillVO
object
11 properties
CommonResponse_List_BalanceVO
object
4 properties
CouponRecordVO
object
4 properties
UploadUrlDTO
object
2 properties
CommonResponse_List_StepRateDTO
object
4 properties
PageResult_UserRecentTradeDTO
object
4 properties
CommonResponse_UserStepRateDTO
object
4 properties
CommonResponse_UploadUrlDTO
object
4 properties
UserRecentTradeDTO
object
5 properties
UserStepApplyDTO
object
4 properties
CommonResponse_PageResult_UserRecentTradeDTO
object
4 properties
UserStepRateDTO
object
19 properties
StepRateDTO
object
12 properties
UserStepApplyResultDTO
object
3 properties
CommonResponse_UserStepApplyResultDTO
object
4 properties
UserCollectionDTO
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

xt-com-default-api-openapi.yml Raw ↑

Other APIs XT.COM publishes across the network.

XT.COM Spot API
XT TradeKit MCP Server
XT.COM Basic Error Controller API
XT.COM Listen Key API
XT.COM 合约聪明钱 Order API
XT.COM Symbol Controller API
XT.COM 获取交易对配置信息(v2) API
XT.COM 获取交易对配置信息(v3) API
Where this information came from

This is an independent, third-party profile of XT.COM 合约信息 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.