用途:bybit-v5 是 Bybit AI Skills 下的统一 API 技能,让智能体用自然语言调用 Bybit V5 接口进行交易,覆盖现货、线性(USDT/USDC 永续)、反向(反向永续/期货)与期权,共 274 个端点,结果均为 JSON。
主要能力:行情类无需鉴权,含 K 线、标记/指数/溢价 K 线、交易品种信息、订单簿、Ticker、资金费率历史、近期成交、持仓量、历史波动率、保险基金、风险限额、交割价、多空比、价格限制等;交易类需鉴权,含下单、改单、撤单、批量下单/改单/撤单、查实时与历史订单、预检查、现货借币检查;持仓类含查询持仓、设置杠杆、逐仓/全仓切换、TP/SL 模式、仓位模式、风险限额、追踪止损、保证金增减、移仓;账户与资产类含钱包余额、账户信息、手续费率、借贷、抵押、提币、划转、充提记录、小额资产兑换等;用户类含子账户与 API Key 管理。
使用方式:按账户 Region 字段自动选择基础 URL,未设置默认 https://api.bybit.com;测试网统一用 https://api-testnet.bybit.com。鉴权需请求头 X-BAPI-API-KEY、X-BAPI-TIMESTAMP(毫秒)、X-BAPI-SIGN、X-BAPI-RECV-WINDOW(默认 5000),POST 需 Content-Type: application/json,User-Agent 为 bybit-v5/1.0.0 (Skill)。签名串为时间戳+API Key+接收窗口+查询串(GET)或请求体字符串(POST),用 HMAC-SHA256 生成小写十六进制签名,例如:echo -n "${PARAM_STR}" | openssl dgst -sha256 -hmac "${SECRET_KEY}" | cut -d' ' -f2。所有端点共用 category 参数指定产品类型。响应结构为 retCode、retMsg、result、retExtInfo、time,retCode=0 表示成功。
限流与场景:响应头 X-Bapi-Limit、X-Bapi-Limit-Status、X-Bapi-Limit-Reset-Timestamp 提供限流信息,各端点有限速(如下单 10-20/s、查单 50/s)。适合需要自动化行情读取、下单与账户资产管理的量化或智能体场景。
限制:需自备 API Key 与密钥并完成签名,涉及资金操作存在风险;完整端点参数、错误码与各接口细节请以官方文档为准,本资料未提供的内容暂未提供。