兴业证券API接口能帮你做什么
很多做股票和期货的朋友都想过一个问题：能不能让电脑自动帮我盯着盘，到了价格就买，到了止损就卖，不用自己整天坐在屏幕前面？兴业证券的API接口就是干这个的。它把券商的下单通道、行情数据、账户查询这些功能，打包成一套程序能调用的工具，你用Python、C++或者Java写一段代码，就能让电脑替你去交易。
股票和期货都能用。股票方面，A股、ETF、可转债都支持。期货方面，兴业证券通过旗下期货子公司或者对接的期货通道，也能实现商品期货、金融期货的程序化交易。
接口到底给了你哪些能力
行情数据：能拿到实时报价、五档盘口、历史K线、分笔成交。做股票日内策略，或者期货跨期套利，行情是基础。兴业证券的API提供Level-1行情，部分版本支持Level-2，具体看你申请的权限。
交易下单：限价单、市价单、条件单都行。股票买卖、期货开平仓、撤单、查持仓、查资金，全部可以用代码完成。你写好一个策略，比如“当5日均线上穿20日均线时买入”，接口就会在信号触发时自动报单。
账户管理：实时查询股票持仓、期货持仓、可用资金、保证金占用。这对风控特别重要。期货是保证金交易，你得随时知道自己的风险度，接口能直接返回这些数字。
数据推送：除了你主动去查，接口还支持订阅推送。股票价格一变动，或者期货合约有成交，服务器主动把数据推给你的程序，延迟更低。
怎么拿到这个接口
兴业证券的API不是开箱即用的，需要走一个申请流程。
你首先得有兴业证券的普通账户，或者兴业期货的账户。然后联系你的客户经理，说明你要做程序化交易，申请API权限。券商通常会要求你签署一份程序化交易风险揭示书，有的还会要求你提供策略说明，确认你不是做高频恶意刷单。
审核通过后，你会拿到一套开发包，里面包括接口文档、示例代码、测试环境的地址和账号。测试环境很重要，先用模拟账号跑通整个流程，确认下单、撤单、查持仓都没问题，再切换到实盘。
实盘接入的时候，券商会给你分配一个专用的接入地址和密钥。你的程序通过这个地址和密钥登录，才能发指令。
股票和期货接口的差别
股票API和期货API在用法上有些不同，新手容易搞混。
股票：买卖单位是股，100股一手。下单时主要填证券代码、买卖方向、价格、数量。股票没有杠杆，除非你用了融资融券。接口里融资买入、融券卖出是单独的指令类型。
期货：买卖单位是手，每手对应不同的合约乘数。比如螺纹钢一手10吨，黄金一手1000克。下单时要指定合约代码，比如rb2410代表2024年10月到期的螺纹钢。期货有开仓和平仓的区别，开仓又分买入开仓和卖出开仓，平仓分买入平仓和卖出平仓。接口里这些方向必须填对，填错了可能变成锁仓或者意外开新仓。
期货还有保证金和每日无负债结算。你的程序需要每天收盘后检查结算单，确认保证金充足。如果保证金不够，期货公司会强平，接口会返回相应的错误码。
一个简单的代码演示
下面用Python伪代码展示股票下单的基本逻辑，实际接口函数名以兴业证券官方文档为准。
# 导入兴业证券API模块（假设模块名为xyzq_api）
from xyzq_api import Trader
# 创建交易对象，填入你的账号和密钥
trader = Trader(account='你的账号', password='你的密码',
server='实盘接入地址')
# 登录
trader.login()
# 查询股票可用资金
cash = trader.query_cash()
print('可用资金:', cash)
# 买入股票：代码600000，价格10.5元，数量100股
order_id = trader.buy_stock(symbol='600000', price=10.5, volume=100)
print('委托编号:', order_id)
# 查询该委托状态
status = trader.query_order(order_id)
print('委托状态:', status)
# 撤单
trader.cancel_order(order_id)
# 登出
trader.logout()
期货下单类似，只是函数名换成期货专用，并且要指定开平方向。
# 期货开仓：买入开仓螺纹钢rb2410，价格3500，1手
order_id = trader.futures_open(symbol='rb2410', direction='buy',
offset='open', price=3500, volume=1)
# 期货平仓：卖出平仓螺纹钢rb2410，价格3550，1手
order_id = trader.futures_open(symbol='rb2410', direction='sell',
offset='close', price=3550, volume=1)
注意：实盘代码必须加入异常处理和风控判断，不能裸奔。
用接口做交易必须注意的事
频率限制：券商对API调用有频率限制，股票通常每秒最多几十次，期货可能更宽松。你如果把程序写成死循环疯狂查询，会被限流甚至封禁。合理做法是用行情推送代替轮询。
风控前置：程序里一定要先检查可用资金、持仓数量、涨跌停价格，再发指令。尤其是期货，保证金不足时下单会被拒绝，频繁被拒可能触发券商风控。
网络断线：程序要能处理断线重连。断线期间行情可能错过，策略信号可能失效。稳妥的做法是断线后先查持仓和委托，再决定是否继续。
合规要求：程序化交易不能影响市场正常秩序。虚假申报、频繁撤单、自成交这些行为会被交易所处罚。你的策略要避免这些动作。
测试充分：模拟环境跑一周以上，覆盖各种边界情况，比如涨跌停、停牌、除权除息。实盘先用小资金跑，确认稳定再放大。
接口适合谁用
有编程基础的股票期货投资者最合适。如果你不会写代码，可以找量化平台对接兴业证券的接口，那些平台提供图形化界面，你拖拽模块就能生成策略。但底层还是这套API在干活。
资金量不大的散户，用接口的主要好处是纪律性。程序不会因为恐惧提前平仓，也不会因为贪婪不止损。股票定投、期货趋势跟踪这类策略，用程序执行比手动执行靠谱得多。
资金量大的机构，接口是用来做算法交易的。大单拆成小单，降低冲击成本；或者做套利，股票和期货之间的价差，人工盯不过来，程序可以毫秒级响应。
兴业证券的API接口，本质上是给你一把自动交易的钥匙。钥匙本身不赚钱，怎么用钥匙打开的门后面的路，才是你真正要花心思的地方。
