欧易API：解锁加密货币交易新维度
账户信息查询
在复杂且瞬息万变的加密货币市场中，精确且及时的账户信息查询是制定稳健交易策略的基石。欧易API提供了一整套全面的接口，旨在为开发者提供安全、高效且可靠的账户数据访问途径。这些接口允许开发者获取各类关键账户数据，从而更好地理解账户状态，优化交易决策。这些数据包括但不限于账户余额快照、可用资金明细、冻结资金明细，以及可追溯的历史交易记录等。
通过
GET /api/v5/account/balance
接口，用户可以获取其账户中各种加密货币和法币的详细余额信息。该接口的返回值中会包含每个币种的可用余额（
availBal
），即可立即用于交易的金额；冻结余额（
frozenBal
），即由于挂单或其他原因被暂时冻结的金额；以及总余额（
bal
），代表该币种的总资产价值。这些数据对于细致的风险评估、动态的仓位调整和量化的交易策略优化至关重要。准确了解余额情况有助于避免过度杠杆和意外爆仓风险。
GET /api/v5/account/positions
接口提供了查询当前持仓情况的功能，覆盖了现货、合约等多种交易类型。返回数据包括持仓数量（
posAmt
），即当前持有某种资产的数量；平均持仓价格（
avgPx
），是计算盈亏的基础；未实现盈亏（
upl
），反映了当前持仓的浮动盈亏情况；和已实现盈亏（
realizedPnl
），记录了已平仓部分的实际盈亏。通过持续监控这些关键指标，用户可以实时评估其投资组合的表现，快速识别潜在风险和机会，并根据市场变化及时做出相应的调整，例如止盈止损或加仓减仓。
对于有审计需求或需要进行深入历史数据分析的用户，
GET /api/v5/account/bills
接口提供了极其详细的账单记录查询功能。用户可以根据时间范围、特定币种类型和各种账单类型进行精准筛选，从而获取涵盖交易记录、充值记录、提现记录、手续费支出等各类账单信息。这些全面的信息对于个人财务管理、企业财务审计、税务申报以及构建量化交易模型等应用场景具有不可替代的重要意义。合理利用这些数据能够帮助用户更好地理解资金流向，优化交易成本，并确保财务合规。
交易下单与管理
欧易API为用户提供了全面的交易下单和管理功能，允许用户自动化交易策略和高效管理订单。通过
POST /api/v5/trade/order
接口，用户可以提交包括限价单、市价单、止盈止损单等多种订单类型。每个订单都必须精确定义其参数，以确保按照预期执行。
下单时，用户需要指定交易对（
instId
），例如BTC-USDT、ETH-USDT等，明确交易的资产。交易方向（
side
）必须指定为买入（
buy
）或卖出（
sell
），以确定是买入做多还是卖出做空。订单类型（
ordType
）包括限价单（
limit
）、市价单（
market
）和高级订单类型，如冰山订单和时间加权平均价格 (TWAP) 订单。下单数量（
sz
）表示交易的资产数量，单位通常是基础货币。
例如，要以限价方式购买1个BTC-USDT，并且设定价格为30000 USDT，用户可以构造并发送如下JSON格式的请求：
{
"instId": "BTC-USDT",
"side": "buy",
"ordType": "limit",
"px": "30000",
"sz": "1"
}
成功提交订单后，API会返回一个唯一的订单ID（
orderId
），该ID是后续查询和管理订单的关键。用户可以使用该ID通过
GET /api/v5/trade/order
接口查询订单的实时状态和详细信息。返回的信息包括订单状态（
state
），可能的取值包括
live
（未成交）、
filled
（已成交）、
canceled
（已撤销）、
partially_filled
(部分成交) 等。还可以获取成交均价（
avgPx
），即订单的平均成交价格，以及成交数量（
filledSz
），即已成交的资产数量。挂单价格 (
px
) 则表明订单设置的委托价格。
对于未完全成交或未成交的订单，用户可以通过
POST /api/v5/trade/cancel-order
接口发起撤销请求。撤销订单时，必须准确指定要撤销的订单ID（
orderId
）和对应的交易对（
instId
），确保撤销操作的准确性。撤销成功后，订单状态将变为
canceled
。
为了满足高频交易和复杂策略的需求，欧易API提供了批量下单和批量撤单功能，分别通过
POST /api/v5/trade/batch-orders
和
POST /api/v5/trade/batch-cancel-orders
接口实现。通过批量操作，用户可以在一次API调用中提交或撤销多个订单，显著提高交易效率，降低延迟，尤其适用于需要同时管理多个关联订单的情况。批量下单允许用户一次性提交多个不同参数的订单，例如不同价格和数量的限价单，而批量撤单允许用户一次性取消多个未成交的订单。
欧易API还集成了止盈止损单（OCO，One-Cancels-the-Other）功能，增强了交易的风险管理能力。用户可以同时设置一个止盈价格和一个止损价格。当市场价格达到其中任何一个触发价格（
triggerPx
）时，系统会自动提交一个预设的限价单或市价单，帮助用户锁定盈利或限制潜在的损失。委托价格(
orderPx
) 是指触发后提交的订单的委托价格，可以设置为限价或市价。止盈止损单允许用户预先设定风险控制参数，无需持续监控市场，从而实现自动化风险管理。
市场数据获取
准确且及时的市场数据是制定明智交易决策的基石。欧易API 提供了全面的市场数据接口，覆盖了从实时行情到深度订单簿，再到历史交易记录等多个维度，为用户提供深入的市场洞察。
通过
GET /api/v5/market/ticker
接口，用户可以获取指定交易对的关键市场指标，例如最新成交价（
last
）、过去24小时的最高价（
high24h
）和最低价（
low24h
），以及24小时成交量（
vol24h
）。 这些指标能够快速反映市场情绪和价格变动，帮助交易者把握市场脉搏，评估整体市场趋势。
GET /api/v5/market/depth
接口提供指定交易对的深度数据，展示了买单和卖单的分布情况，包括最佳买一价、最佳卖一价以及对应的挂单数量。 深度数据反映了市场供需关系，是评估市场流动性和潜在支撑/阻力位的关键信息。通过分析深度数据，用户可以更好地理解市场的买卖压力，从而优化交易策略。
GET /api/v5/market/trades
接口允许用户获取指定交易对的最新成交记录，包括成交时间、成交价格和成交数量等详细信息。 实时跟踪成交记录能够帮助用户了解市场的即时交易活跃度，判断价格波动的潜在原因，并及时发现异常交易行为。
欧易API 提供
GET /api/v5/market/candles
接口，专门用于获取 K 线数据，允许用户获取指定交易对在不同时间周期内的历史价格数据，例如 1 分钟 K 线、5 分钟 K 线、1 小时 K 线、日 K 线等。 K 线数据是技术分析的基础，交易者可以利用这些数据进行各种技术分析，例如趋势线绘制、形态识别、指标计算等，从而辅助交易决策，制定更完善的交易计划。
WebSocket实时推送
除了传统的REST API之外，欧易API还提供了高效的WebSocket实时推送服务，用于满足对数据实时性有较高要求的应用场景。 通过WebSocket，用户无需频繁请求，即可实时接收包括市场深度、最新成交价、账户资产变动以及订单执行状态等关键信息。 这种方式相较于REST API的轮询机制，能极大地降低数据传输延迟，确保用户能够以最快的速度获取最新的市场动态和账户信息，从而做出更迅速的交易决策。
用户可以通过订阅不同的频道来选择性地接收所需数据。
例如，订阅
spot/ticker
频道可以实时获取现货交易对的最新成交价、最高价、最低价和成交量等行情数据，订阅
account
频道可以接收账户余额的实时更新，包括可用余额、冻结余额和总权益等信息，而订阅
trade
频道则可以接收订单状态的实时更新，例如订单的创建、成交、部分成交和取消等状态变更。
灵活的频道订阅机制允许用户定制数据流，避免不必要的数据传输，从而优化网络带宽的使用。
WebSocket连接建立成功后，服务器会主动向客户端推送JSON格式的数据。 这种基于事件驱动的推送方式需要客户端具备解析JSON数据的能力，并根据业务逻辑对接收到的数据进行相应的处理，例如更新UI界面、触发交易策略或记录日志等。 用户需要根据API文档中定义的JSON数据结构，编写相应的解析代码，以确保能够正确地提取和使用推送的数据。
使用WebSocket服务时，需要特别注意以下几个关键事项：
- WebSocket连接是一种长连接，客户端需要维护连接的稳定性，确保在网络波动或服务器重启等情况下连接不会中断。 建议实现心跳机制，定期向服务器发送ping消息，以检测连接状态并保持连接活跃。
- 为了降低服务器负载，用户应仅订阅自己实际需要的数据频道，避免订阅过多不必要的数据。 过多的订阅不仅会增加服务器的压力，也会消耗客户端的计算资源和网络带宽。 仔细评估业务需求，选择最合适的订阅频道，以实现资源利用的最大化。
- 如果WebSocket连接意外断开，客户端应具备自动重连机制，确保在连接中断后能够自动尝试重新建立连接。 重连机制需要考虑到重连的频率和策略，避免频繁重连对服务器造成额外的负担。 可以采用指数退避算法来控制重连的频率，以降低重连的概率和对服务器的影响。
安全性考虑
在使用欧易API进行交易时，安全性至关重要。用户必须采取必要的预防措施，妥善保管API Key和Secret Key，切勿将其泄露给任何第三方。密钥泄露可能导致资产损失和其他安全风险。
欧易API采用强大的签名认证机制来确保每个请求的真实性和完整性。用户必须在每个API请求中包含签名，该签名通过Secret Key对请求参数进行加密生成。这种签名过程验证请求的来源，防止恶意篡改。
为增强安全性，强烈建议设置IP白名单。IP白名单允许用户指定可以访问API的IP地址范围，阻止未经授权的访问尝试。这限制了潜在攻击者的攻击面，只有来自信任IP的请求才会被处理。用户应该仔细配置API Key的权限，仅授予其执行交易所需的最小权限。例如，可以限制API Key只能进行交易，而不能进行提现操作。
定期监控API Key的使用情况是必不可少的。密切关注交易历史和API请求日志，寻找任何异常或未经授权的活动迹象。如检测到可疑行为，例如未知的交易或不寻常的请求，应立即采取行动。如果怀疑API Key已被泄露或盗用，应立即禁用或更换API Key，以防止进一步的损害。审查并更新安全设置，确保最佳的安全态势。
通过实施这些多层安全措施，用户可以显著降低风险，有效保护其欧易账户和加密货币资产的安全。
