NAV
English
go

更新日志

2021-03-30

2021-08-24

2020-12-22

2020-11-16

2020-10-30

2020-10-29

2020-10-28

2020-10-27

简介

API 概述

FAMEEX 为您提供了一套简单又强大的 API 接口,帮助您快速、高效的获取行情和进行交易。

使用 API 前,请先创建您个人的 API,获取您的 AccessKey 和 SecretKey,并设置 API 的 IP 访问限制。

API 的交易权限让您可以快速的获取当前市场最新行情及时的下单交易、查询自己可用和冻结金额、查询自己当前尚未成交的挂单、买进或卖出、撤单。

FAMEEX 官网首页: www.fameex.com

如果在使用过程中有任何问题,请联系 FAMEEX 官方客服,

我们的联系方式如下:

官方客服邮箱:Service@mail.fameex.info

官方微博:https://weibo.com/fameexgroup

官方 Twitter:https://twitter.com/FAMEEXGLOBAL

官方 Telegram:https://t.me/fameexgroup

官方 Facebook:https://www.facebook.com/FAMEEXGLOBAL

我们将为您做出最权威的解答。

接入说明

接入 URLs

接入 URLs 说明
https://api.fameex.com RESTFUL API
wss://www.fameex.com/ws WebSocket Feed(行情)

所有请求基于 Https 协议,POST 请求的请求头信息中 contentType 需要统一设置为:’application/json’

鉴于延迟高和稳定性差等原因,不建议通过代理的方式访问 FAMEEX- API。

限频规则

限制频率:每个接口的限制不同 。

单个 API Key 维度限制,建议行情 API 访问也要加上签名,否则限频会更严格。

限频规则 数据类型 说明
对每个 AccessKey 及每个 url 的频率限制 20 次/2s(大部分接口)

请求头设置

请求头(header)的参数如下:

参数 数据类型 说明
AccessKey string 您申请的 Accesskey
SignatureMethod string HmacSHA256
SignatureVersion string v1.0
Timestamp int64 请求时间的时间戳; 单位: 秒
Signature string 签名
Content-Type string application/json

请求头(header)的参数解释:

API 访问密钥(AccessKey):您申请的 API 的 AccessKey。

签名方法(SignatureMethod):用户计算签名的基于哈希的协议,此处使用 HmacSHA256。

签名版本(SignatureVersion):签名协议的版本,此处使用 v1.0。

时间戳(Timestamp):您发出请求的时间。 如:2019-07-24 00:00:00 对应时间戳 1563897600。在查询请求中包含此值有助于防止第三方截取您的请求。

签名(Signature):签名计算得出的值,用于确保签名有效和未被篡改。

签名

1、签名说明

API 请求在通过 internet 传输的过程中极有可能被篡改,为了确保请求未被更改,除推送服务接口外的私有接口均必须使用您的 API 的 AccessKey 和 SecretKey 做签名认证,以校验参数或参数值在传输途中是否发生了更改。

方法请求地址:即访问服务器地址 api.fameex.com,比如 api.fameex.com/v1/order/orders

API Key 包含以下两部分:

AccessKey:API 访问密钥

SecretKey: 签名认证加密所使用的密钥(仅申请时可见)

Signature是对timestamp(单位 秒) + method(GET或POST) + requestPath + body字符串(+表示字符串连接)拼接的字符串,使用 secretKey,按照 HMAC SHA256 方法加密,通过 hex 编码输出而得到的。

其中,timestamp的值与请求头的Timestamp相同,必须是 UTC 时区 Unix 时间戳的十进制秒数格式或 ISO8601 标准的时间格式,精确到秒

method 是请求方法,字母全部大写:GET/POST

requestPath 是请求接口路径。例如:/orders?state=1&type=2

body 是指请求主体的字符串(去掉空白字符,如\n,\r,\t),如果请求没有主体(通常为 GET 请求)则 body 可省略。例如:{"orderId":"377454671037440"}

secretKey 为用户申请 API Key 时所生成。例如:533d6e70-21b2-eb5c-f801-c128021c70a1

Websocket 行情推送

心跳连接

功能说明:

长连接心跳

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "ping"
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("ping")

返回示例:

{
  "code": 200,
  "op": "pong"
}

响应参数

字段名称 数据类型 说明
code int 200,正常
op string 消息类型("pong")

登录信息

功能说明:

长连接登录

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "req",
  "topic": "auth",
  "params": {
    "platform": "API",
    "accessKey": "e690af61-bc06-d936-50fc-4053bdc2cf85"
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("req")
topic string 请求主题("auth")
params object 参数
accessKey string 申请的 AccessKey
platform string 平台来源(WEB/APP/API)

返回示例:

{
  "code": 200,
  "op": "req",
  "topic": "auth"
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
op string 消息类型("req")
topic string 请求主题("auth")

推送 K 线信息

功能说明:

此接口注册 K 线服务

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "sub",
  "topic": "spot.market.kline",
  "params": {
    "symbol": "BTC-USDT",
    "period": "1"
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("sub")
topic string 订阅主题("spot.market.kline")
params object 参数
symbol string 币对名称(如,"BTC-USDT")
period string K 线时间粒度(1,5,15,30,60,120,240,1D)

返回示例:

{
  "code": 200,
  "op": "req",
  "topic": "auth",
  "data": {
    "symbol": "BTC-USDT",
    "period": "1",
    "time": 1603785494,
    "open": "103.4",
    "low": "103.4",
    "high": "103.4",
    "close": "103.4",
    "amount": "1.66",
    "volume": "200.12"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
op string 消息类型("sub")
topic string 请求主题("spot.market.kline")
data object 返回数据实体
symbol string 币对名称(如,“BTC-USDT”)
period string K 线时间粒度(1,5,15,30,60,120,240,1D)
time int64 开始时间戳,秒
open string 开盘价
low string 最低价
high string 最高价
close string 最新价
amount string 交易币成交量
volume string 计价币成交量

推送首页行情

功能说明:

此接口注册首页行情服务

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "sub",
  "topic": "spot.market.ticker",
  "params": {
    "symbol": "BTC-USDT"
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("sub")
topic string 订阅主题("spot.market.kline")
params object 参数
symbol string 币对名称(如,"BTC-USDT")

返回示例:

{
  "code": 200,
  "op": "sub",
  "topic": "spot.market.ticker",
  "data": {
    "symbol": "BTC-USDT", //币对名称
    "gain": "0.12", //24小时涨幅
    "open": "103.4", //24小时开盘价
    "low": "103.4", //24小时最低价
    "high": "103.4", //24小时最高价
    "close": "103.4", //最新成交价
    "amount": "1.66", //24小时交易币成交量
    "volume": "200.12", //24小时计价币成交量
    "quotePrice": "450.12" //计价币价格
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
op string 消息类型("sub")
topic string 请求主题("spot.market.ticker")
data object 返回数据实体
symbol string 币对名称(如,“BTC-USDT”)
open string 24 小时开盘价
low string 24 小时最低价
high string 24 小时最高价
close string 最新成交价
amount string 24 小时交易币成交量
volume string 24 小时计价币成交量
quotePrice string 计价币价格

推送深度行情

功能说明:

此接口注册深度服务

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "sub",
  "topic": "spot.market.ticker",
  "params": {
    "symbol": "BTC-USDT",
    "step": "step0"
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("sub")
topic string 订阅主题("spot.market.ticker")
params object 参数
symbol string 币对名称(如,"BTC-USDT")
step string 深度的价格聚合度类型(step0~step4)

返回示例:

{
  "code": 200,
  "op": "sub",
  "topic": "spot.market.ticker",
  "data": {
    "symbol": "BTC-USDT", //币对名称
    "step": "step0", //深度的价格聚合度类型
    "time": 1603785494, //时间戳
    "bids": [["123.12", "1.2"]], //当前的所有买单 [价格,数量]
    "asks": [["123.12", "1.2"]] //当前的所有卖单 [价格,数量]
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
op string 消息类型("sub")
topic string 请求主题("spot.market.depth")
data object 返回数据实体
symbol string 币对名称(如,“BTC-USDT”)
step string 深度的价格聚合度类型(step0~step4)
time string 时间戳,秒
bids array 当前的所有买单 [价格,数量]
asks array 当前的所有卖单 [价格,数量]

推送最新成交订单行情

功能说明:

此接口推送最新成交订单详情

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "sub",
  "topic": "spot.market.last_trade",
  "params": {
    "symbol": "BTC-USDT"
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("sub")
topic string 订阅主题("spot.market.last_trade")
params object 参数
symbol string 币对名称(如,"BTC-USDT")

返回示例:

{
  "code": 200,
  "op": "sub",
  "topic": "spot.market.last_trade",
  "data": [
    {
      "symbol": "BTC-USDT", //币对名称
      "tradeId": "10384834938169458677", //成交单ID
      "side": 1, //委托方向 1-买 2-卖
      "price": "7890.12", //成交价格
      "amount": "1.12", //成交数量
      "createTime": 156655468 //创建时间
    }
  ]
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
op string 消息类型("sub")
topic string 请求主题("spot.market.last_trade")
data object 返回数据实体
symbol string 币对名称(如,“BTC-USDT”)
tradeId string 成交单 ID
side string 委托方向 1-买 2-卖
price array 成交价格
amount array 成交数量
createTime int64 创建时间戳,秒

推送订单成交或者撤销

功能说明:

推送买卖方或自己订单成交或取消

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "sub",
  "topic": "spot.orders",
  "params": {
    "symbol": "BTC-USDT"
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("sub")
topic string 订阅主题("spot.orders")
params object 参数
symbol string 币对名称(如,"BTC-USDT")

返回示例:

{
  "code": 200,
  "op": "sub",
  "topic": "spot.orders",
  "data": {
    "symbol": "BTC-USDT", //币对名称
    "orderId": "10384834938169458688", //委托单ID
    "clientOid": "10567108063048237056", //用户自编委托单ID
    "side": 1, //委托方向 1-买 2-卖
    "orderType": 1, //委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做Maker
    "price": "7890.12", //委托价格
    "amount": "1.12", //委托数量
    "money": "1.12", //委托金额(市价买时)
    "filledAmount": "1.12", //已成交数量
    "filledMoney": "8562.12", //已成交金额
    "filledFee": "1.12", //已成交手续费
    "feeCurrency": "usdt", //手续费币种
    "triggerPrice": "7600.12", //委托单触发价
    "triggerType": "gte", //委托单触发类型 gte-大于等于 lte-小于等于
    "triggerState": 1, //触发状态 1-触发成功
    "liquidationType": 1, //强平类型 1-爆仓
    "strategyId": "123456789", //策略Id
    "strategyType": 1, //策略类型
    "strategyName": "abc", //策略名称
    "state": 1, //委托单状态 1-已创建 2-等待成交 3-部分成交 4-完全成交 5-部分成交撤销 6-已撤销
    "accountType": "spot", //账户类型
    "platform": "API", //平台来源
    "cancelType": 1, //撤单类型 1-用户撤单 2-系统撤单 3-运营撤单
    "createTime": 15665546871, //创建时间
    "updateTime": 15665546872 //状态更新时间
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
op string 消息类型("sub")
topic string 请求主题("spot.orders")
data object 返回数据实体
symbol string 币对名称(如,“BTC-USDT”)
orderId string 订委托单 ID
clientOid string 用户自编委托单 ID
side int 订委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托单价格
amount string 委托数量
money string 委托金额(市价买时)
filledAmount sting 已成交数量
filledMoney sting 已成交金额
filledFee string 已成交手续费
feeCurrency string 手续费币种
triggerPrice string 委托单触发价
triggerType string 委托单触发类型 gte-大于等于 lte-小于等于
triggerState int 触发状态 1-触发成功
liquidationType int 委强平类型 1-爆仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 策略名称
state int 委托单状态 1-已创建 2-等待成交 3-部分成交 4-完全成交 5-部分成交撤销 6-已撤销
accountType string 账户类型
platform int 平台来源
cancelType int 撤单类型 1-用户撤单 2-系统撤单 3-运营撤单
createTime int64 下单时间戳,秒
updateTime int64 状态更新时间戳,秒

注销首页行情

功能说明:

此接口注销首页行情服务

请求路径:

wss://www.fameex.com/spot

请求方式:

websocket

请求示例:

{
  "op": "unsub",
  "topic": "spot.market.ticker",
  "params": {
    "symbol": "BTC-USDT",
    "period": "",
    "step": "",
    "activityId": ""
  }
}

参数:

参数 是否必须 数据类型 说明
op string 消息类型("unsub")
topic string 订阅主题("spot.orders")
params object 参数
symbol string 币对名称(如,"BTC-USDT")
step string 深度的价格聚合度类型(step0~step4)
period string 时间粒度 例( "1","5","15","30","60","120","240","1D","1W")
activityId string 活动 ID

返回示例:

{
  "code": 200,
  "op": "unsub",
  "topic": "spot.market.ticker"
}

响应参数

参数 数据类型 说明
code int 200, 正常 =
op string 消息类型("unsub")
topic string 请求主题("spot.market.ticker")

基础 API 接口

获取当前系统时间

限速规则:20 次/2s

功能说明:

获取当前系统时间,单位秒

请求路径:

/v1/common/timestamp

curl https://api.fameex.com/v1/common/timestamp

路由参数:

Post 参数:

返回示例:

{
  "code": 200,
  "ts": 1553254857,
  "data": 1553254857
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
ts int64 请求时间, 秒
data int64 返回值,当前时间, 秒

获取所有交易币对

限速规则:20 次/2s

功能说明:

此接口返回 FAMEEX 平台支持的所有交易币对。

请求路径:

/v1/common/symbols

curl https://api.fameex.com/v1/common/symbols

路由参数:

Post 参数:

返回示例:

{
  "code": 200,
  "ts": 1554178231,
  "msg": "",
  "total": 20,
  "data": [
    {
      "base": "ETH",
      "pair": "ETH/BTC",
      "quote": "BTC",
      "pricePercision": "6",
      "amountPercision": "2",
      "permitAmount": "0.2"
    }
  ]
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
ts int64 请求时间, 秒
msg string 此次返回值说明
total int 交易币对总数量
data list 返回数据:币对信息
base string 交易币
quote string 计价币
pair string 交易币对
pricePercision string 交易对中计价币种的精度(小数点后位数)
amountPercision string 交易对中交易币种的精度(小数点后位数)
permitAmount string 最小挂单数量

获取所有交易币种

限速规则:20 次/2s

功能说明:

此接口返回 FAMEEX 支持的所有交易币种。

请求路径:

/v1/common/currencys

curl https://api.fameex.com/v1/common/currencys

路由参数:

Post 参数:

返回示例:

{
  "code": 200,
  "data": {
    "list": [
      {
        "currency": "USDT",
        "nameZh": "泰达币",
        "nameEn": "Tether",
        "isBase": 1,
        "isQuote": 1,
        "currencyDetail": {
          "ERC20": {
            "id": 49,
            "chainType": "ERC20",
            "currencyRecharge": {
              "state": 1,
              "minChargeAmount": "1",
              "blockConfirmNumber": 10
            },
            "currencyWithdraw": {
              "state": 1,
              "onceminwithdraw": "5",
              "daymaxwithdrawtimes": 5,
              "feewithdraw": "1.5"
            },
            "warnrule": {
              "withDrawAmount": "0",
              "withDrawAmountToCny": "0",
              "withDrawTimes": 0,
              "chargeAmount": "0",
              "chargeAmountToCny": "0"
            }
          }
        }
      },
      {
        "currency": "BTC",
        "nameZh": "比特币",
        "nameEn": "Bitcoin",
        "isBase": 1,
        "isQuote": 1,
        "currencyDetail": {
          "BTC": {
            "id": 48,
            "chainType": "BTC",
            "currencyRecharge": {
              "state": 1,
              "minChargeAmount": "1",
              "blockConfirmNumber": 10
            },
            "currencyWithdraw": {
              "state": 1,
              "onceminwithdraw": "0.01",
              "daymaxwithdrawtimes": 5,
              "feewithdraw": "0.005"
            },
            "warnrule": {
              "withDrawAmount": "0",
              "withDrawAmountToCny": "0",
              "withDrawTimes": 0,
              "chargeAmount": "0",
              "chargeAmountToCny": "0"
            }
          }
        }
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string 此次返回值说明
data list 返回数据:币种信息
currency string 币种简称
nameEn string 英文名
nameZh string 中文名
isBase int 1-可以作为交易币 2-不可以作为交易币
isQuote int 1-可以作为计价币 2-不可以作为计价币
minChargeAmount string 最小充币数量
blockConfirmNumber int 区块确认数
onceminwithdraw string 单次最大提币数量
daymaxwithdrawtimes int 单日最大提币次数
feewithdraw string 提币手续费
currencyRecharge 里的 state int 充币的状态 1-开启 2-关闭
currencyWithdraw 里的 state int 提币的状态 1-开启 2-关闭

行情接口

深度信息

请求示例

curl --request GET 'https://api.fameex.com/api/v2/orderbook?symbol=BTC-USDT&limit=5'

响应

{
  "timestamp": 1648456620000,
  "bids": [
    [
      "50006.1", // 价格
      "0.024" // 挂单量
    ]
  ],
  "asks": [
    [
      "50006.34", // 价格
      "0.01" // 挂单量
    ]
  ]
}

HTTP 请求

GET /api/v2/orderbook

请求参数

参数 是否必须 数据类型 说明
symbol YES string 示例例: "BTC-USDT"
limit NO int 可选值:[5, 10, 20, 50, 100]

响应参数

参数 数据类型 说明
timestamp int 当前时间
bids string bid 的价格和數量信息,最优 bid 价格由上到下排列
asks string ask 的价格和數量信息,最优 ask 价格由上到下排列

近期成交列表

请求示例

curl --request GET 'https://api.fameex.com/api/v2/trades?symbol=BTC-USDT'

响应

[
  {
    "trade_id": 728356542914519040,
    "price": "71000",
    "base_volume": "0.001",
    "quote_volume": "71",
    "timestamp": 1648456620000,
    "type": "sell"
  },
  {
    "trade_id": 728342639237160960,
    "price": "70727.2",
    "base_volume": "0.001",
    "quote_volume": "70.7272",
    "timestamp": 1648453305000,
    "type": "buy"
  }
]

HTTP 请求

GET /api/v2/trades

请求参数

参数 是否必须 数据类型 说明
symbol YES string 示例例: "BTC-USDT"
limit NO int 默认 100; 最大值 100.

响应参数

参数 数据类型 说明
trade_id int 成交单 ID
price string 成交价
base_volume string 成交量
quote_volume string 成交额
timestamp int 成交时间, 毫秒(ms)
type string 买卖方向

K 线数据

限速规则:20 次/2s

功能说明:

此接口获取历史 K 线数据。

请求路径:

/v1/market/history/kline

curl https://api.fameex.com/v1/market/history/kline

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称, 例"ETH-BTC"
period string 时间粒度 例( "1","5","15","30","60","120","240","1D","1W")
startTime int64 开始时间,时间戳(单位:秒)
endTime int64 结束时间,时间戳(单位:秒)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "time": 1570518900,
      "amount": "0.01",
      "open": "0.00481",
      "close": "0.00481",
      "low": "0.00481",
      "hight": "0.00481",
      "volume": "100"
    }
  ]
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
time int64 时间戳
amount string 交易币成交量
open string 开盘价
close string 收盘价
low string 最低价
hight string 最高价
volume string 计价币成交量

24hr 价格变动情况

请求示例

curl --request GET 'https://api.fameex.com/api/v2/ticker/24hr'

响应

[
  {
    "trading_pairs": "XLM-BTC",
    "last_price": "0.01",
    "lowest_ask": "0",
    "highest_bid": "0",
    "base_volume": "0",
    "quote_volume": "0",
    "price_change_percent_24h": "0",
    "highest_price_24h": "0.01",
    "lowest_price_24h": "0.01"
  },
  {
    "trading_pairs": "WINK-USDT",
    "last_price": "6.48",
    "lowest_ask": "6.48",
    "highest_bid": "6.47",
    "base_volume": "0.15432",
    "quote_volume": "0.9999936",
    "price_change_percent_24h": "0",
    "highest_price_24h": "6.48",
    "lowest_price_24h": "6.48"
  }
]

HTTP 请求

GET /api/v2/ticker/24hr

请求参数

参数 是否必须 数据类型 说明
symbol NO string 示例例: "BTC-USDT"

响应参数

参数 数据类型 说明
trading_pairs string 币对名称
last_price string 最新成交价
lowest_ask string 最佳卖价
highest_bid string 最佳买价
base_volume string 成交量
quote_volume string 成交额
price_change_percent_24h string 24 小时涨幅
highest_price_24h string 24 小时最高价
lowest_price_24h string 24 小时最低价

最新价格

HTTP 请求

GET /api/v2/ticker/price

请求示例

curl --request GET 'https://api.fameex.com/api/v2/ticker/price'

响应

{
  "ETH-USDT": {
    "last_price": "1097.8",
    "base_volume": "0",
    "quote_volume": "0"
  },
  "WINK-USDT": {
    "last_price": "6.48",
    "base_volume": "0.15432",
    "quote_volume": "0.9999936"
  }
}

请求参数

参数 是否必须 数据类型 说明
symbol NO string 示例例: "BTC-USDT"

响应参数

参数 数据类型 说明
last_price string 最新成交价
base_volume string 成交量
quote_volume string 成交额

币币交易 API 接口

币币下单

限速规则:100 次/2s

功能说明:

此接口提供撤销指定的某一种或多种币对的所有未成交订单的功能。

请求路径:

/v1/api/spot/orders

curl https://api.fameex.com/v1/api/spot/orders

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称 例如:"BTC-USDT"
clientOid string 用户自编委托单 ID
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量(市价买时为交易额)
triggerPrice string 触发价格
backRatio string 跟踪委托的回调比例

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "10383992916667793408",
    "clientOid": "10383992916667793408"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string 信息说明
data object 委托单信息
orderId string 委托单 ID
clientOid string 用户自编委托单 ID

币币撤单

限速规则:100 次/2s

功能说明:

此接口提供将未成交的订单撤销的功能。

请求路径:

/v1/api/spot/cancel_orders

curl https://api.fameex.com/v1/api/spot/cancel_orders

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称 例如:"BTC-USDT"
orderid string 委托单 ID(orderId 和 clientOid 必须且只能选一个填写)
clientOid string 用户自编委托单 ID(orderId 和 clientOid 必须且只能选一个填写)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "10383992916667793408"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string 说明
data object 返回委托单信息
orderId string 委托单 ID
clientOid string 用户自编委托单 ID

币币批量撤单

限速规则:100 次/2s

功能说明:

此接口提供撤销指定的某一种或多种币对的所有未成交订单的功能。

请求路径:

/v1/api/spot/cancel_orders_all

curl https://api.fameex.com/v1/api/spot/cancel_orders_all

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称 例如:"BTC-USDT"
orderIds array 委托单 ID 列表(orderId 和 clientOid 必须且只能选一个填写)
clientOids array 用户自编委托单 ID 列表(orderId 和 clientOid 必须且只能选一个填写)
{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "code": 200,
      "orderId": "111111"
    }
  ]
}

响应参数

字段名称 数据类型 说明
code int 200,正常
msg string 说明
data object array 批量撤单详情
code array 批量撤单详情
orderId string 委托单 ID
clientOid string 用户自编委托单 ID

获取委托单详情

限速规则:20 次/2s

功能说明:

此接口通过订单 ID 获取指定委托单信息。

请求路径:

/v1/api/spot/orderdetail

curl https://api.fameex.com/v1/api/spot/orderdetail

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称,例如“BTC-USDT”
orderId string 委托单 ID(orderId 和 clientOid 必须且只能选一个填写)
clientOid string 用户自编委托单 ID(orderId 和 clientOid 必须且只能选一个填写)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "symbol": "BTC-USDT",
    "orderId": "1111111",
    "side": 1,
    "orderType": 1,
    "price": "50000",
    "amount": "0.002",
    "filledAmount": "0.001"
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data object 返回值,订单详情
orderId string 委托单 ID
clientOid string 用户自编委托单 ID
symbol string 币对名称(例:BTC-USDT)
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量
money string 委托金额(市价买时)
filledAmount string 已成交数量
filledMoney string 已成交金额
filledFee string 已成交手续费
feeCurrency string 手续费币种
triggerPrice string 委托单触发价
triggerType string 委托单触发类型 gte-大于等于 lte-小于等于
triggerState int 触发状态 1-触发成功
liquidationType int 强平类型 1-爆仓 2-减仓 3-止盈减仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 订策略名称
state int 委托单状态 1-已创建 2-等待成交 3-部分成交 4-完全成交 5-部分成交撤销 6-已撤销
accountType string 账户类型
platform string 平台来源
cancelType int 撤单类型 1-用户撤单 2-系统撤单 3-运营撤单 4-爆仓撤单 5-减仓撤单
createTime int64 创建时间
updateTime int64 状态更新时间

获取委托单列表

限速规则:20 次/2s

功能说明:

此接口获取列出您当前的委托单信息(最近 3 个月的委托单信息)。这个请求支持分页,并且按时间倒序排序和存储,最新的排在最前面。

请求路径:

/v1/api/spot/orderlist

curl https://api.fameex.com/v1/api/spot/orderlist

headers参数

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
base string 交易币(大写,例如“BTC”)
quote string 计价币(大写,例如“USDT”)
side string 委托方向 1-买 2-卖
orderTypes int array 委托类型列表 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
state int 委托单状态 7-未完成 8-已完成 9-完全成交或部分成交撤销
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
startTime int64 开始时间戳,秒
endTime int64 结束时间戳,秒
strategyId string 策略 Id
strategyType int 策略类型

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 10,
    "total": "10",
    "orders": [
      {
        "symbol": "BTC-USDT",
        "orderId": "1111111",
        "side": 1,
        "orderType": 1,
        "price": "50000",
        "amount": "0.002",
        "filledAmount": "0.001"
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data object 返回值,订单详情
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
total int 总条数
orders object array 委托单列表
orderId string 委托单 ID
clientOid string 用户自编委托单 ID
symbol string 币对名称(例:BTC-USDT)
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量
money string 委托金额(市价买时)
filledAmount string 已成交数量
filledMoney string 已成交金额
filledFee string 已成交手续费
feeCurrency string 手续费币种
triggerPrice string 委托单触发价
triggerType string 委托单触发类型 gte-大于等于 lte-小于等于
triggerState int 触发状态 1-触发成功
liquidationType int 强平类型 1-爆仓 2-减仓 3-止盈减仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 订策略名称
state int 委托单状态 1-已创建 2-等待成交 3-部分成交 4-完全成交 5-部分成交撤销 6-已撤销
accountType string 账户类型
platform string 平台来源
cancelType int 撤单类型 1-用户撤单 2-系统撤单 3-运营撤单 4-爆仓撤单 5-减仓撤单
createTime int64 创建时间
updateTime int64 状态更新时间

获取成交明细

限速规则:20 次/2s

功能说明:

此接口获取您当前所有的成交订单信息。这个请求支持分页,并且按时间倒序排序和存储,最新的排在最前面。

请求路径:

/v1/api/spot/fills

curl https://api.fameex.com/v1/api/spot/fills

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
base string 交易币(大写,例如“BTC”)
quote string 计价币(大写,例如“USDT”)
orderId string 委托单 ID
side int 委托方向 1-买 2-卖
orderTypes int array 委托类型列表 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
startTime int64 开始时间戳,秒
endTime int64 结束时间戳,秒
strategyId string 策略 Id
strategyType int 策略类型

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 10,
    "total": "10",
    "trades": [
      {
        "symbol": "BTC-USDT",
        "tradeId": "1111111",
        "orderId": "1111111",
        "side": 1,
        "orderType": 1,
        "price": "50000",
        "amount": "0.002",
        "feeCurrency": "BTC",
        "feeRate": "0.0001",
        "fee": "0.000001",
        "accountType": "spot",
        "platform": "api",
        "role": "maker",
        "createTime": "1629854950"
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data object 返回值,订单详情
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
total int 总条数
trades object array 委成交单列表
orderId string 委托单 ID
tradeId string 成交单 ID
symbol string 币对名称(例:BTC-USDT)
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量
feeRate string 实际手续费率
feeCurrency string 手续费币种
fee string 手续费
liquidationType int 强平类型 1-爆仓 2-减仓 3-止盈减仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 订策略名称
accountType string 账户类型
platform string 平台来源
role string 角色类型 1-maker 2-taker
selfTrade int 是否自成交 1-自成交
createTime int64 创建时间

获取所有未完成的订单

限速规则:20 次/2s

功能说明:

此接口获取您当前所有的成交订单信息。这个请求支持分页,并且按时间倒序排序和存储,最新的排在最前面。

请求路径:

/v1/api/orders_pending

curl https://api.fameex.com /v1/api/orders_pending

路由参数:

参数 是否必须 数据类型 说明
pairName string 币对名称(例:BTC_USDT)
pageNum string 分页使用, 第几页,从第一页开始
pageSize string 分页使用, 每页数量 (0< pageSize ≤ 500)

Post 参数:

返回示例:

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "pageNum": 1,
    "pageSize": 100,
    "list": [
      {
        "orderId": "11403650861072384000",
        "pairName": "OMG_ETH",
        "price": "0.00477",
        "count": "1",
        "buyType": 1,
        "buyClass": 0,
        "dealedCount": "0",
        "dealedMoney": "0",
        "state": 1,
        "time": 1571040752762737823
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data string 返回值,成交明细
pairName string 币对名称(例:BTC_USDT)
orderId string 订单编号
buyClass int 交易类型: 0 限价交易
buyType int 买卖方向: 0 买, 1 卖
price string 委托价格
count string 委托数量
dealedCount string 已成交数量
dealedMoney string 已成交金额
state int 1 未生效 2 未成交 3 部分成交
time int64 时间(单位:纳秒)

钱包 API 接口

获取钱包账户信息

限速规则:20 次/2s

功能说明:

此接口获取钱包币币账户所有资产信息列表,查询各币种的余额、冻结和可用等信息。

请求路径:

/v1/api/account/wallet

curl https://api.fameex.com/v1/api/account/wallet

路由参数:

Post 参数:

返回示例:

{
  "code": 200,
  "data": [
    {
      "list": [
        {
          "available": "0.00000000",
          "currency": "USDT",
          "hold": "0.00000000",
          "total": "0.00000000"
        },
        {
          "available": "0.00000000",
          "currency": "BTC",
          "hold": "0.00000000",
          "total": "0.00000000"
        }
      ],
      "walletType": "c2c"
    }
  ],
  "userid": "85942975"
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
data list 返回值,币币账户数据
userid string 用户 id
walletType string 账户类型:spot-现货账户 otc-法币账户 l2c-杠杆账户
available string 可用余额
total string 总余额
currency string 币种 例:BTC
hold string 冻结金额

获取钱包账户某币种详情

限速规则:20 次/2s

功能说明:

获取钱包账户详情(单一币种)

请求路径:

/v1/api/account/wallet/currency

curl https://api.fameex.com/v1/api/account/wallet/currency

路由参数:

参数 是否必须 数据类型 说明
currency string 币种, 例 BTC

Post 参数:

返回示例:

{
  "code": 200,
  "data": {
    "available": "20.00000000",
    "hold": "2.00000000"
  },
  "msg": "Success",
  "userid": "481"
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string 此次返回值说明
userid string 用户 id
data map 返回值,币币账户,某一币种的详情
available string 可用余额
hold string 冻结金额

资金划转

限速规则:1 次/2s

功能说明:

此接口提供平台内现货钱包、法币钱包、杠杆钱包之间进行资金划转。【注:杠杆账户币对之间互相划转仅支持计价币之间的划转,例如从杠杆账户下的 BTC_USDT 将 USDT 划转至 ETH_USDT 币对下】

请求路径:

POST /v1/api/account/transfer

curl https://api.fameex.com/v1/api/account/transfer

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
currency string 币种类型
amount string 数量
from string 转出账户: spot 现货账户, otc 法币账户,l2c 杠杆账户,swap U 合约账户
to string 转入账户: spot 现货账户, otc 法币账户,l2c 杠杆账户,swap U 合约账户
fromPair string 杠杆账户币对间互转时的转出币对,例:BTC_USDT
toPair string 杠杆账户币对间互转时的转入币对,例:ETH_USDT

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderid": "541989259557478400",
    "userid": "72473826"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data object 资金划转返回的响应对象
orderid string 订单 id
userid string 用户 id

获取现货账户交易账单

限速规则:20 次/2s

功能说明:

此接口查询现货账户交易账单。

请求路径:

POST /v1/api/spot/record/trade

curl https://api.fameex.com/v1/api/spot/record/trade

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
tradeType int 交易类型:0.全部;2.买入;3.卖出;4.实收手续费
currency string 币种名称 例:ETH
pageNum int 第几页,1 开始
pageSize int 每页数量 (0 < pageSize ≤ 500)
startTime int64 开始时间 秒 最多查询最近 90 天内的记录
endTime int64 结束时间 秒

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "userId": "",
    "total": 4,
    "list": [
      {
        "tradeType": 3,
        "operateTime": 1606755600,
        "currency": "USDT",
        "amount": "1.99991550"
      },
      {
        "tradeType": 3,
        "operateTime": 1606701601,
        "currency": "USDT",
        "amount": "0.99979000"
      },
      {
        "tradeType": 3,
        "operateTime": 1606096802,
        "currency": "USDT",
        "amount": "0.99979000"
      },
      {
        "tradeType": 3,
        "operateTime": 1605492004,
        "currency": "USDT",
        "amount": "0.99979000"
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data object 空字符串
userId string 用户 id
total int 账单记录数量
list array 账单记录列表
tradeType int 交易类型:2.买入;3.卖出;4.实收手续费
operateTime int64 操作时间
currency string 币种名称 例:ETH
amount string 数量

获取现货账户充提账单

限速规则:20 次/2s

功能说明:

此接口查询现货账户充提账单。

请求路径:

POST /v1/api/spot/record/chargewithdraw

curl https://api.fameex.com/v1/api/spot/record/chargewithdraw

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
tradeType int 交易类型:0.全部;1.提币;2.充币
currency string 币种名称 例:ETH
startTime int64 开始时间:秒级时间戳
endTime int64 结束时间时间:秒级时间戳
pageNum int 页码,从 1 开始
pageSize int 每页数量 (0 < pageSize ≤ 500)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "total": 4,
    "list": [
      {
        "tradeType": 2,
        "currency": "USDT",
        "address": "1AUVYs7LfhnZMi7DkD6FeLqsXrXaWy4P9Z",
        "amount": "4.00000000",
        "fee": "1.00000000",
        "label": "",
        "chainType": "USDT_OMNI",
        "state": 3,
        "txId": "INTERNAL",
        "operateTime": 1603784595254607137
      },
      {
        "tradeType": 2,
        "currency": "USDT",
        "address": "1AUVYs7LfhnZMi7DkD6FeLqsXrXaWy4P9Z",
        "amount": "4.00000000",
        "fee": "1.00000000",
        "label": "",
        "chainType": "USDT_OMNI",
        "state": 1,
        "txId": "",
        "operateTime": 1603423928893177788
      },
      {
        "tradeType": 2,
        "currency": "USDT",
        "address": "1AUVYs7LfhnZMi7DkD6FeLqsXrXaWy4P9Z",
        "amount": "4.00000000",
        "fee": "1.00000000",
        "label": "",
        "chainType": "USDT_OMNI",
        "state": 5,
        "txId": "",
        "operateTime": 1603335471347179187
      },
      {
        "tradeType": 2,
        "currency": "USDT",
        "address": "1AUVYs7LfhnZMi7DkD6FeLqsXrXaWy4P9Z",
        "amount": "4.00000000",
        "fee": "1.00000000",
        "label": "",
        "chainType": "USDT_OMNI",
        "state": 1,
        "txId": "",
        "operateTime": 1603334047527967315
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data object 空字符串
total int 账单记录数量
list array 账单记录列表
tradeType int 交易类型:1.提币;2.充币
operateTime int64 操作时间
currency string 币种名称 例:ETH
amount string 数量
address string 当 tradeType 为 1 时,代表提币地址;tradeType 为 2 时,代表充币地址
fee string 提币手续费
label string 用户的标签
chainType string 币种的链类型
state int 账单状态:
当 tradeType 为 1 时, state 分别代表: 1-待审核; 2-审核中; 3-已完成; 4-审核失败; 5-已撤单; 6-提币失败; 7-初始化创建; 8-确认中
当 tradeType 为 2 时, state 分别代表: 1-已完成
txId string 交易哈希

获取现货账户划转账单

限速规则:20 次/2s

功能说明:

此接口查询现货账户划转账单。

请求路径:

POST /v1/api/spot/record/trans

curl https://api.fameex.com/v1/api/spot/record/trans

`路由参数:

Post 参数:

参数 是否必须 数据类型 说明
tradeType int 交易类型:0.全部;1.转入;2.转出
currency string 币种名称 例:ETH
startTime int64 开始时间:秒级时间戳
endTime int64 结束时间时间:秒级时间戳
pageNum int 页码,从 1 开始
pageSize int 每页数量 (0 < pageSize ≤ 500)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "userId": "35856194",
    "total": 16,
    "list": [
      {
        "userId": "35856194",
        "tradeType": 2,
        "currency": "USDT",
        "fromCoinPair": "",
        "toCoinPair": "",
        "fromAccount": 0,
        "toAccount": 1,
        "amount": "500.00000000",
        "operateTime": 1600863239,
        "state": 1
      },
      {
        "userId": "35856194",
        "tradeType": 2,
        "currency": "USDT",
        "fromCoinPair": "",
        "toCoinPair": "",
        "fromAccount": 0,
        "toAccount": 1,
        "amount": "450.00000000",
        "operateTime": 1600863103,
        "state": 1
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data object 空字符串
userId string 用户 id
total int 账单记录数量
list array 账单记录列表
tradeType int 交易类型:1.转入;2.转出
operateTime int64 操作时间
currency string 币种名称 例:ETH
amount string 数量
fromCoinPair string 转入币对
toCoinPair string 转出币对
fromAccount string 转出账户:0.现货;1.杠杆;3.法币
toAccount string 转入账户:0.现货;1.杠杆;3.法币

获取现货账户其他账单

限速规则:20 次/2s

功能说明:

此接口查询现货账户其他账单,包括返佣及活动。

请求路径:

POST /v1/api/spot/record/others

curl https://api.fameex.com/v1/api/spot/record/others

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
tradeType int 交易类型:0.全部;1.返佣;2.活动
currency string 币种名称 例:ETH
startTime int64 开始时间:秒级时间戳
endTime int64 结束时间时间:秒级时间戳
pageNum int 页码,从 1 开始
pageSize int 每页数量 (0 < pageSize ≤ 500)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "userId": "94433127",
    "total": 14,
    "list": [
      {
        "tradeType": 1,
        "currency": "BTC",
        "amount": "0.01",
        "operateTime": 1608086059
      },
      {
        "tradeType": 1,
        "currency": "BTC",
        "amount": "0.01",
        "operateTime": 1608086059
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data object 空字符串
userId string 用户 id
total int 账单记录数量
list array 账单记录列表
tradeType int 交易类型:1.返佣;2.活动
operateTime int64 操作时间:秒级时间戳
currency string 币种名称 例:ETH
amount string 数量

获取充币地址

限速规则:20 次/2s

功能说明:

此接口获取各个币种的充币地址。

请求路径:

/v1/api/account/deposit/address

curl https://api.fameex.com/v1/api/account/deposit/address

路由参数:

参数 是否必须 数据类型 说明
coinType string 币种类型 USDT
chainType string 链类型 ERC20

Post 参数:

返回示例:

{
  "code": 200,
  "msg": "success",
  "request": {
    "userId": "66491610",
    "coinType": "btc",
    "label": ""
  },
  "data": {
    "userId": "66491610",
    "coinType": "btc",
    "code": 200,
    "address": "1DDceT2o3zQS6dYzLg3HGG9Y787DfGXMLA",
    "exportAddr": ""
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
request map 请求参数
userId string 用户 id
coinType string 币种
address string 地址

获取杠杆账户信息

限速规则:1 次/2s

功能说明:

此接口获取杠杆账户所有资产信息列表,查询各币种的余额、冻结和可用等信息。

请求路径:

/v1/api/lever/accounts

curl https://api.fameex.com/v1/api/lever/accounts

路由参数:

Post 参数:

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "walletType": "l2c",
    "list": [
      {
        "baseAvailable": "0.00000000",
        "baseBorrowed": "0.00000000",
        "baseCurrency": "ETH",
        "baseHold": "0.00000000",
        "baseInterest": "0.00000000",
        "baseTotal": "0.00000000",
        "coinpair": "ETH/USDT",
        "quoteAvailable": "0.00000000",
        "quoteBorrowed": "0.00000000",
        "quoteCurrency": "USDT",
        "quoteHold": "0.00000000",
        "quoteInterest": "0.00000000",
        "quoteTotal": "0.00000000"
      },
      {
        "baseAvailable": "0.00000000",
        "baseBorrowed": "0.00000000",
        "baseCurrency": "ADA",
        "baseHold": "0.00000000",
        "baseInterest": "0.00000000",
        "baseTotal": "0.00000000",
        "coinpair": "ADA/USDT",
        "quoteAvailable": "10.00000000",
        "quoteBorrowed": "0.00000000",
        "quoteCurrency": "USDT",
        "quoteHold": "0.00000000",
        "quoteInterest": "0.00000000",
        "quoteTotal": "10.00000000"
      }
    ]
  },
  "userid": "72473826"
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
data list 返回值,杠杆账户数据
userid string 用户 id
walletType string 账户类型:spot-币币账户 otc-法币账户 l2c-杠杆账户
coinpair string 币对名称 例:BTC/USDT
baseCurrency string 交易币名称 例:BTC
quoteCurrency string 计价币名称 例:USDT
baseAvailable string 交易币可用金额
quoteAvailable string 计价币可用金额
baseHold string 交易币冻结金额
quoteHold string 计价币冻结金额
baseTotal string 交易币总额
quoteTotal string 计价币总额
baseBorrowed string 交易币借币金额
quoteBorrowed string 计价币借币金额
baseInterest string 交易币利息
quoteInterest string 计价币利息

杠杆交易 API 接口

获取杠杆账户下某币对详情

限速规则:1 次/2s

功能说明:

获取杠杆账户下某币对账户余额、冻结和可用等信息

请求路径:

/v1/api/lever/accounts

curl https://api.fameex.com/v1/api/lever/accounts

路由参数:

参数 是否必须 数据类型 说明
pairName string 币对, 例 BTC_USDT

Post 参数:

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "baseAvailable": "0.60029232",
    "baseBorrowed": "1",
    "baseCurrency": "BTC",
    "baseHold": "0",
    "baseInterest": "0.000042",
    "baseTotal": "0.60029232",
    "coinpair": "BTC/USDT",
    "quoteAvailable": "3902.45765848",
    "quoteBorrowed": "219.34",
    "quoteCurrency": "USDT",
    "quoteHold": "0",
    "quoteInterest": "0.00921228",
    "quoteTotal": "3902.45765848",
    "burstPrice": "9213.53694692",
    "riskRate": "112.25"
  },
  "userid": "72473826"
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
data list 返回值,杠杆账户数据
msg string code 响应信息
userid string 用户 id
coinpair string 币对名称 例:BTC/USDT
baseCurrency string 交易币名称 例:BTC
quoteCurrency string 计价币名称 例:USDT
baseAvailable string 交易币可用金额
quoteAvailable string 计价币可用金额
baseHold string 交易币冻结金额
quoteHold string 计价币冻结金额
baseTotal string 交易币总额
quoteTotal string 计价币总额
baseBorrowed string 交易币借币金额
quoteBorrowed string 计价币借币金额
baseInterest string 交易币利息
quoteInterest string 计价币利息
burstPrice string 爆仓价
riskRate string 爆仓风险率

杠杆下单

限速规则:1 次/2s

功能说明:

此接口提供杠杆下单功能。

请求路径:

/v1/api/lever/orders/place

curl https://api.fameex.com/v1/api/lever/orders/place

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称 例如:"BTC-USDT"
clientOid string 用户自编委托单 ID
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量(市价买时为交易额)
triggerPrice string 触发价格
backRatio string 跟踪委托的回调比例

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "10383992916667793408",
    "clientOid": "10383992916667793408"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string 信息说明
data object 委托单信息
orderId string 委托单 ID
clientOid string 用户自编委托单 ID

杠杆撤单

限速规则:1 次/2s

功能说明:

此接口提供将未成交的杠杆订单撤销的功能。

请求路径:

/v1/api/lever/orders/cancel

curl https://api.fameex.com/v1/api/lever/orders/cancel

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称 例如:"BTC-USDT"
orderid string 委托单 ID(orderId 和 clientOid 必须且只能选一个填写)
clientOid string 用户自编委托单 ID(orderId 和 clientOid 必须且只能选一个填写)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "10383992916667793408"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string 说明
data object 返回委托单信息
orderId string 委托单 ID
clientOid string 用户自编委托单 ID

杠杆批量撤单

限速规则:1 次/2s

功能说明:

此接口提供撤销指定的某一种或多种币对的所有未成交的杠杆订单的功能。

请求路径:

/v1/api/lever/orders/batch_cancel

curl https://api.fameex.com/v1/api/lever/orders/batch_cancel

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称 例如:"BTC-USDT"
orderIds array 委托单 ID 列表(orderId 和 clientOid 必须且只能选一个填写)
clientOids array 用户自编委托单 ID 列表(orderId 和 clientOid 必须且只能选一个填写)
{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "code": 200,
      "orderId": "111111"
    }
  ]
}

响应参数

字段名称 数据类型 说明
code int 200,正常
msg string 说明
data object array 批量撤单详情
code array 批量撤单详情
orderId string 委托单 ID
clientOid string 用户自编委托单 ID

获取杠杆委托单列表

限速规则:1 次/2s

功能说明:

列出您当前的委托单信息(最近 3 个月的委托单信息)。这个请求支持分页,并且按时间倒序排序和存储,最新的排在最前面。

请求路径:

/v1/api/lever/orders

curl https://api.fameex.com/v1/api/lever/orders

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
base string 交易币(大写,例如“BTC”)
quote string 计价币(大写,例如“USDT”)
side string 委托方向 1-买 2-卖
orderTypes int array 委托类型列表 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
state string 委托单状态 7-未完成 8-已完成 9-完全成交或部分成交撤销
pageNum string 分页, 第几页(1<=pageNum)
pageSize string 分页, 每页数量(1<=pageSize<= 500)
startTime string 开始时间戳,秒
endTime string 结束时间戳,秒
strategyId string 策略 Id
strategyType string 策略类型

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 10,
    "total": "10",
    "orders": [
      {
        "symbol": "BTC-USDT",
        "orderId": "1111111",
        "side": 1,
        "orderType": 1,
        "price": "50000",
        "amount": "0.002",
        "filledAmount": "0.001"
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data object 返回值,订单详情
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
total int 总条数
orders object array 委托单列表
orderId string 委托单 ID
clientOid string 用户自编委托单 ID
symbol string 币对名称(例:BTC-USDT)
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量
money string 委托金额(市价买时)
filledAmount string 已成交数量
filledMoney string 已成交金额
filledFee string 已成交手续费
feeCurrency string 手续费币种
triggerPrice string 委托单触发价
triggerType string 委托单触发类型 gte-大于等于 lte-小于等于
triggerState int 触发状态 1-触发成功
liquidationType int 强平类型 1-爆仓 2-减仓 3-止盈减仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 订策略名称
state int 委托单状态 1-已创建 2-等待成交 3-部分成交 4-完全成交 5-部分成交撤销 6-已撤销
accountType string 账户类型
platform string 平台来源
cancelType int 撤单类型 1-用户撤单 2-系统撤单 3-运营撤单 4-爆仓撤单 5-减仓撤单
createTime int64 创建时间
updateTime int64 状态更新时间

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data string 返回值,订单列表
id int64 数据编号
orderId string 委托单 id
userId string 用户 id
userType int 用户类型 1 普通用户 2 api 用户
userLevel int 用户等级
base string 交易对中的交易币种
quote string 交易对中的计价币种
buyType int 0 买 1 卖
buyClass int 0 限价单
state int 订单状态 1-待撮合 4-taker 完全成交 7-在深度队列 8-taker 部分成交 9-maker 部分成交 10-maker 完全成交 11-已撤销
price string 委托单价
totalPrice string 初始委托价格
count string 未成交数量
lossPrice string 止盈止损触发价
totalCount string 总数量
dealedCount string 已成交数量
dealedMoney string 累计成交额
priceAvg string 成交均价
triggerGreater bool 是否大于等于止盈止损触发价
matchCount int 匹配次数
createTime int64 订单创建时间 单位:纳秒
endTime int64 订单最后的更新时间 单位:纳秒
isErr int 0 正常委托单 其他为解锁资产失败的委托单
triggered int 止盈止损是否触发 0 未触发 1 已触发
accountFlag int 订单类型:1.普通杠杆订单;2.杠杆爆仓
detail object 详情

获取杠杆委托单详情

限速规则:1 次/2s

功能说明:

此接口通过订单 ID 获取指定委托单信息。

请求路径:

/v1/api/lever/orders/detail

curl https://api.fameex.com/v1/api/lever/orders/detail

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
symbol string 币对名称,例如“BTC-USDT”
orderId string 委托单 ID(orderId 和 clientOid 必须且只能选一个填写)
clientOid string 用户自编委托单 ID(orderId 和 clientOid 必须且只能选一个填写)

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "symbol": "BTC-USDT",
    "orderId": "1111111",
    "side": 1,
    "orderType": 1,
    "price": "50000",
    "amount": "0.002",
    "filledAmount": "0.001"
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data object 返回值,订单详情
orderId string 委托单 ID
clientOid string 用户自编委托单 ID
symbol string 币对名称(例:BTC-USDT)
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量
money string 委托金额(市价买时)
filledAmount string 已成交数量
filledMoney string 已成交金额
filledFee string 已成交手续费
feeCurrency string 手续费币种
triggerPrice string 委托单触发价
triggerType string 委托单触发类型 gte-大于等于 lte-小于等于
triggerState int 触发状态 1-触发成功
liquidationType int 强平类型 1-爆仓 2-减仓 3-止盈减仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 订策略名称
state int 委托单状态 1-已创建 2-等待成交 3-部分成交 4-完全成交 5-部分成交撤销 6-已撤销
accountType string 账户类型
platform string 平台来源
cancelType int 撤单类型 1-用户撤单 2-系统撤单 3-运营撤单 4-爆仓撤单 5-减仓撤单
createTime int64 创建时间
updateTime int64 状态更新时间

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data string 返回值,订单详情
orderId string 撮合任务 id
pairName string 币对名称(例:BTC_USDT)
buyType int 买卖方向 0-买 1-卖
buyClass int 委托类型 0-限价 1-市价 2-止盈止损
state int 订单状态 1-待撮合 4-taker 完全成交 7-在深度队列 9-maker 部分成交 10-maker 完全成交 11-已撤销
price string 挂单单价
count string 未成交数量
lossPrice string 止盈止损触发价
totalCount string 总挂单数量
dealedCount string 已成交数量
dealedMoney string 已成交金额
priceAvg string 成交均价
createTime int64 订单创建时间 纳秒
endTime int64 订单状态最后更新时间 纳秒

获取杠杆成交明细

限速规则:1 次/2s

功能说明:

此接口获取您当前所有的成交订单信息。这个请求支持分页,并且按时间倒序排序和存储,最新的排在最前面。

请求路径:

/v1/api/lever/deals

curl https://api.fameex.com/v1/api/lever/deals

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
base string 交易币(大写,例如“BTC”)
quote string 计价币(大写,例如“USDT”)
orderId string 委托单 ID
side int 委托方向 1-买 2-卖
orderTypes int array 委托类型列表 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
startTime int64 开始时间戳,秒
endTime int64 结束时间戳,秒
strategyId string 策略 Id
strategyType int 策略类型

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 10,
    "total": "10",
    "trades": [
      {
        "symbol": "BTC-USDT",
        "tradeId": "1111111",
        "orderId": "1111111",
        "side": 1,
        "orderType": 1,
        "price": "50000",
        "amount": "0.002",
        "feeCurrency": "BTC",
        "feeRate": "0.0001",
        "fee": "0.000001",
        "accountType": "spot",
        "platform": "api",
        "role": "maker",
        "createTime": "1629854950"
      }
    ]
  }
}

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data object 返回值,订单详情
pageNum int 分页, 第几页(1<=pageNum)
pageSize int 分页, 每页数量(1<=pageSize<= 500)
total int 总条数
trades object array 委成交单列表
orderId string 委托单 ID
tradeId string 成交单 ID
symbol string 币对名称(例:BTC-USDT)
side int 委托方向 1-买 2-卖
orderType int 委托类型 1-限价 2-市价 3-止盈止损 4-跟踪委托 5-只做 Maker
price string 委托价格
amount string 委托数量
feeRate string 实际手续费率
feeCurrency string 手续费币种
fee string 手续费
liquidationType int 强平类型 1-爆仓 2-减仓 3-止盈减仓
strategyId string 策略 Id
strategyType int 策略类型
strategyName string 订策略名称
accountType string 账户类型
platform string 平台来源
role string 角色类型 1-maker 2-taker
selfTrade int 是否自成交 1-自成交
createTime int64 创建时间

响应参数

字段名称 数据类型 说明
code int 返回值状态
msg string 返回值描述
data string 返回值,成交明细
pairName string 币对名称(例:BTC_USDT)
base string 交易币
quote string 计价币
orderId string 委托单 id
time int64 成交时间 纳秒
buyClass int 交易类型: 0 限价交易
buyType int 买卖方向: 0 买, 1 卖
price string 成交价格
count string 成交数量
fee string 手续费
feeRate string 实际手续费费率
originFeeRate string 原始手续费费率
accountFlag int 类型:1.普通杠杆订单;2.杠杆爆仓

获取杠杆配置

限速规则:1 次/2s

功能说明:

此接口获取钱包杠杆账户下币对配置信息。

请求路径:

/v1/api/lever/pair/config

curl https://api.fameex.com/v1/api/lever/pair/config

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pairName string 币对名称 例:ETH_USDT

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "coinPair": "TOMO/USDT",
      "leverMultiple": 10,
      "isBorrow": 0,
      "quoteLeatestBorrowAmount": "10",
      "borrowFeeRate": "0.05",
      "quoteMostBorrowAmount": "10000",
      "baseMostBorrowAmount": "10000"
    },
    {
      "coinPair": "BTC/USDT",
      "leverMultiple": 10,
      "isBorrow": 0,
      "quoteLeatestBorrowAmount": "100",
      "borrowFeeRate": "0.000021",
      "quoteMostBorrowAmount": "5000",
      "baseMostBorrowAmount": "100"
    },
    {
      "coinPair": "BNB/USDT",
      "leverMultiple": 4,
      "isBorrow": 0,
      "quoteLeatestBorrowAmount": "10",
      "borrowFeeRate": "0.000001",
      "quoteMostBorrowAmount": "1000000000",
      "baseMostBorrowAmount": "10"
    }
  ]
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data array 返回值,杠杆配置信息
coinPair string 币对名称
leverMultiple string 杠杆倍数
quoteLeatestBorrowAmount string 计价币最少借币金额
borrowFeeRate string 借币费率
quoteMostBorrowAmount string 计价币单日最大可借
baseMostBorrowAmount string 交易币单日最大可借

获取杠杆借币参数

限速规则:1 次/2s

功能说明:

此接口获取用户借币时的提示参数。

请求路径:

/v1/api/lever/borrowparam

curl https://api.fameex.com/v1/api/lever/borrowparam

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pairName string 币对名称 例:ETH_USDT
currency string 币种名称 例:ETH

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "canBorrowAmount": "15",
    "borrowedAmount": "3",
    "borrowFeeRate": "0.0001",
    "leastBorrowAmount": "0"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data array 返回值,杠杆配置信息
canBorrowAmount string 可借金额
borrowedAmount string 已借金额
borrowFeeRate string 计价币最少借币金额
leastBorrowAmount string 最小借币金额

杠杆借币

限速规则:1 次/2s

功能说明:

此接口用于杠杆借币。

请求路径:

/v1/api/lever/borrow

curl https://api.fameex.com/v1/api/lever/borrow

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pairName string 币对名称 例:ETH_USDT
currency string 币种名称 例:ETH
amount string 借币金额

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": ""
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data array 空字符串

获取杠杆还币参数

限速规则:1 次/2s

功能说明:

此接口获取特定币对下特定币种的还币提示参数。

请求路径:

/v1/api/lever/repayparam

curl https://api.fameex.com/v1/api/lever/repayparam

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pairName string 币对名称 例:ETH_USDT
currency string 币种名称 例:ETH

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "borrowedAmount": "1.00000200",
    "interest": "0.00000401",
    "unReturnAmount": "1.00000601",
    "availAmount": "1.99999910"
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data object 返回值,用户还币提示信息
borrowedAmount string 借币未还本金
interest string 借币未还利息
unReturnAmount string 未还金额
availAmount string 该币对下该币种的可用金额

杠杆还币

限速规则:1 次/2s

功能说明:

此接口用于杠杆还币。

请求路径:

/v1/api/lever/repay

curl https://api.fameex.com/v1/api/lever/repay

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pairName string 币对名称 例:ETH_USDT
currency string 币种名称
amount string 还币金额

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": ""
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data array 空字符串

获取杠杆账户借还记录

限速规则:1 次/2s

功能说明:

此接口获取杠杆借还记录信息。

请求路径:

/v1/api/lever/record/borrow_repay

curl https://api.fameex.com/v1/api/lever/record/borrow_repay

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pairName string 币对名称 例:ETH_USDT
currency string 币种名称 例:ETH
pageSize int 每页显示数量
pageNum int 页码

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "list": [
      {
        "borrowedTime": 1603959122,
        "coinPair": "BNB/USDT",
        "coinType": "BNB",
        "recordId": "1603959122152142070",
        "borrowedAmount": "1",
        "amount": "0.000002",
        "borrowFeeRate": "0.0001",
        "interest": "0.00000001",
        "refund": "0.000001",
        "state": 1
      },
      {
        "borrowedTime": 1603958809,
        "coinPair": "BNB/USDT",
        "coinType": "BNB",
        "recordId": "1603958809028866056",
        "borrowedAmount": "1",
        "amount": "0",
        "borrowFeeRate": "0.0001",
        "interest": "0",
        "refund": "0.000001",
        "state": 2
      }
    ],
    "pageNum": 1,
    "pageSize": 5,
    "total": 2
  }
}

响应参数

字段名称 数据类型 说明
code int 200, 正常
msg string success,正常
data list 返回值,杠杆账户数据
borrowedTime int64 借币时间
coinPair string 借币币对名称 例:BTC/USDT
coinType string 借币币种名称 例:BTC
recordId string 借币记录 id
borrowedAmount string 借币数量
amount string 交易币可用金额
borrowFeeRate string 每小时利率
interest string 已还利息
refund string 计价币冻结金额
state int 借币状态:1.未还清;2.已还清

获取杠杆账户账单

限速规则:1 次/2s

功能说明:

此接口获取杠杆账单。

请求路径:

/v1/api/lever/ledger

curl https://api.fameex.com/v1/api/lever/ledger

路由参数:

Post 参数:

参数 是否必须 数据类型 说明
pageNum int 页码
pageSize int 每页显示数量 (0 < pageSize ≤ 500)
currency string 币种类型,不填时返回所有的账单
ledgerType int 账单类型 2 买入 3 买出 4 手续费 5 借币 6 归还利息 7 归还本金 8 系统买入 9 系统卖出 11 强平费 12 转入 13 转出
pairName string 币对类型,不填时返回所有币对的账单

返回示例:

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "ledger_id": "10541354256305774592",
      "coinPair": "BTC/USDT",
      "currency": "BTC",
      "balance": "0.60029232",
      "amount": "0.46417600",
      "typename": "lever_trade",
      "timestamp": "2020-10-28T15:56:40Z"
    },
    {
      "ledger_id": "10541354255949258752",
      "coinPair": "BTC/USDT",
      "currency": "USDT",
      "balance": "653.25823816",
      "amount": "8.73514642",
      "typename": "lever_trade",
      "timestamp": "2020-10-28T15:56:40Z"
    }
  ],
  "total": 239,
  "operateTime": "2020-10-28T18:17:01Z"
}

响应参数

字段名称 数据类型 说明
ledger_id string 账单 ID
coinPair string 币对
currency string 币种
balance string 余额
amount string 变动数量
typename string 账单类型
timestamp string 账单创建时间

错误信息

code 码 说明
200 正常
112002 API 单个 Key 流量超限
112005 API 请求频率超限
112007 API-Key 创建失败
112008 API-Key 说明名称已存在
112009 API-Key 创建数量超限(单个用户最多创建 5 个 API)
112010 API-Key 失效(单个 Key 的时限为 60 天自然日)
112011 API 请求 IP 访问受限(绑定 IP 与请求 IP 不一致)
112015 签名错误
112020 签名方式错误
112021 签名版本错误
112022 签名时间戳错误
112047 现货 API 接口暂时不可访问
112048 期货 API 接口暂时不可访问
230030 请通过 KYC 认证后进行操作

常见问题

常见问题
1.什么是交易币种?什么是计价币种?交易量是以交易币种还是计价币种进行数量统计?
答:
每一个交易币对都是由 交易币种/计价币种 组成的,币对中前方为交易货币,后方为计价货币。
举例说明:BTC/USDT 这个交易币对中,BTC 为交易货币,USDT 为计价货币。
交易量是以交易币种为准进行统计。
成交总额是以计价币种为准进行统计。
2.Rest 访问限制?
答:
1.单个 IP 限制每分钟 1200 次访问,超过 1200 次将被锁定 1 小时,一小时后自动解锁。
2.单个用户限制每秒钟 20 次访问,一秒钟内 20 次以上的请求,将会视作无效。
3.WebSocket 访问限制?
答:
单个用户限制每秒钟 50 次访问,一秒钟内 50 次以上的请求,将会视作无效。
4.生成的密钥有什么用处?
答:
密钥是用来操作 API 的钥匙,在调用 API 接口时需要提供 API 密钥。私有密钥只在刚生成时显示一次,遗忘需重新生成。
5.k 线图是否可以获取几个月或者一年前的数据?
答:
系统 k 线图最多只提供 1000 条数据,如果要获取比较久的数据需要使用小时或者天的单位获取。
6.API 的 IP 是否需要绑定?
答:
1.API 的 IP 绑定有效的防止除了这个 IP 之外的服务器进行调用自己的权限进行交易操作。
2.绑定 IP 后,只能由绑定的 IP 进行访问,如不绑定,则不限制访问 IP。
7.API 是否支持提币?
答:
不支持,提币必须现在 FAMEEX 官网进行提币。
8.公钥私钥可以提供给别人吗?
答:
不建议,会导致资产损失。
9.签名失败频繁?
• 检查 API Key 是否有效,是否复制正确,是否有绑定 IP 白名单;
• 检查时间戳是否是 UTC 时间;
• 检查参数是否按字母排序;
• 检查编码;
• 检查签名编码应该是 hex;
• 检查 是否以表单方式提交;
• 检查 的 url 是否带着签名字段,POST 的数据格式是否是 json 格式;
• 检查签名结果是否有进行 URI 编码。
10.返回 login-required?
• 检查参数 account-id 是否是由 /v1/account/accounts 接口返回的,而不是填的 UID;
• 检查请求是否把业务参数也计算进签名;
• 检查请求是否将参数按照 ASCII 码表顺序排序。
11.返回 gateway-internal-error?
检查请求是否在 header 中声明 Content-Type:application/json。
go