接口权限
是否有权限调用接口需要注意下面两个地方:
- 接口鉴权
- API权限
接口鉴权
是指用户调用的时候,需要按照接口指定的方式传递APIKEY和验签参数。每个接口第一行都会有接口需要什么样的鉴权的说明。
简单说,接口分为以下3种情况来鉴权:
接口类型 | 鉴权类型 | 说明 |
---|---|---|
公用接口 | NONE | 不需要X-BM-KEY,不需要X-BM-SIGN |
私有接口 | KEYED | 需要X-BM-KEY,不需要X-BM-SIGN |
私有接口 | SIGNED | 需要X-BM-KEY,需要X-BM-SIGN |
API KEY 权限
是指用户在申请API的时候给API指定授权。即用户在BitMart网站页面申请API KEY的时候,可以勾选API 权限, 如:交易权限(包括合约交易和现货交易)。(默认:只读权限)。
详细如下:
接口 | 说明 | 鉴权类型 | 权限 |
---|---|---|---|
/account/v1/currencies | 获取资产币种 | NONE | 不需要权限 |
/account/v1/wallet | 查询账户资产 | KEYED | 只读权限 |
/account/v1/deposit/address | 查询充币地址 | KEYED | 只读权限 |
/account/v1/withdraw/charge | 查询提币额度 | KEYED | 提现权限 |
/account/v1/withdraw/apply | 提币 | SIGNED | 提现权限 |
/account/v1/recharge-withdraw/history | 查询充提历史记录 | KEYED | 只读权限 |
/account/v1/recharge-withdraw/detail | 查询单条充提记录 | KEYED | 只读权限 |
/contract/v1/ifcontract/contracts | 获取合约列表 | NONE | 不需要权限 |
/contract/v1/ifcontract/indexes | 查询所有合约的指数价格 | NONE | 不需要权限 |
/contract/v1/ifcontract/pnls | 查询自动减仓排序表 | NONE | 不需要权限 |
/contract/v1/ifcontract/depth | 获取合约深度 | NONE | 不需要权限 |
/contract/v1/ifcontract/fundingrate | 获取资金费率 | NONE | 不需要权限 |
/contract/v1/ifcontract/indexquote | 获取指数价格 K 线 | NONE | 不需要权限 |
/contract/v1/ifcontract/quote | 获取K线数据 | NONE | 不需要权限 |
/contract/v1/ifcontract/tickers | 获取合约最新行情 | NONE | 不需要权限 |
/contract/v1/ifcontract/trades | 获取历史合约成交记录 | NONE | 不需要权限 |
/contract/v1/ifcontract/accounts | 查询用户账户信息 | KEYED | 只读权限 |
/contract/v1/ifcontract/batchOrders | 批量下单 | SIGNED | 交易权限 |
/contract/v1/ifcontract/cancelOrders | 取消订单 | SIGNED | 交易权限 |
/contract/v1/ifcontract/marginOper | 调整保证金 | SIGNED | 交易权限 |
/contract/v1/ifcontract/orderTrades | 订单的交易记录 | KEYED | 只读权限 |
/contract/v1/ifcontract/positionFee | 查询仓位费用 | KEYED | 只读权限 |
/contract/v1/ifcontract/submitOrder | 提交订单 | SIGNED | 交易权限 |
/contract/v1/ifcontract/userLiqRecords | 查询爆仓记录 | KEYED | 只读权限 |
/contract/v1/ifcontract/userOrderInfo | 查询订单详情 | KEYED | 只读权限 |
/contract/v1/ifcontract/userOrders | 查询订单记录 | KEYED | 只读权限 |
/contract/v1/ifcontract/userPositions | 查询用户仓位 | KEYED | 只读权限 |
/contract/v1/ifcontract/userTrades | 查询交易记录 | KEYED | 只读权限 |
/spot/v1/currencies | 获取平台所有的加密货币列表 | NONE | 不需要权限 |
/spot/v1/symbols | 获取平台所有的交易对列表 | NONE | 不需要权限 |
/spot/v1/symbols/details | 获取平台所有交易对的详情列表 | NONE | 不需要权限 |
/spot/v1/ticker | 查询交易对最新成交价、买一价、卖一价和 24 小时交易量的快照信息 | NONE | 不需要权限 |
/spot/v1/steps | 获取平台支持的全部 k 线周期,用分钟表示 | NONE | 不需要权限 |
/spot/v1/symbols/kline | 获取指定交易对的指定时间范围内的 k 线数据 | NONE | 不需要权限 |
/spot/v1/symbols/book | 获取交易对完整的深度 | NONE | 不需要权限 |
/spot/v1/symbols/trades | 获取指定交易对的最近成交记录 | NONE | 不需要权限 |
/spot/v1/wallet | 获取用户所有币种钱包余额 | KEYED | 只读权限 |
/spot/v1/submit_order | 委托下单 | SIGNED | 交易权限 |
/spot/v1/cancel_order | 取消一个未完成的订单 | SIGNED | 交易权限 |
/spot/v1/cancel_orders | 取消指定交易对指定方向的所有未完成的订单 | SIGNED | 交易权限 |
/spot/v1/order_detail | 获取订单详情 | KEYED | 只读权限 |
/spot/v1/orders | 查询用户最近订单 | KEYED | 只读权限 |
/spot/v1/trades | 用户成交历史 | KEYED | 只读权限 |