跳到主要内容

获取最近一次结算资金费率

API说明​

此接口返回的是最近一次结算时点的资金费率，此费率与下一次结算时点的资金费率无必然联系，且距此时已过去较长时间了。

注意： 资金费率数据可通过 RESTful 和 Websocket 两种 API 获取。本页面描述的是 RESTful 接口。有关实时资金费率更新的信息, 请点击 跳转

注意事项​

  1. 此接口返回的是最近一次结算时点的资金费率，此费率与下一次结算时点的资金费率无必然联系，且距此时已过去较长时间了。

  2. RESTful API 提供最近一次结算时的资金费率信息，WebSocket API 和 Webpage 提供实时资金费率数据的获取。

  3. 对于合约中未列出的合约，将返回以下响应：

{'code': 9001, 'msg': 'Contract not found'}

认证​

这是一个公共接口，不需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

请求方法​

GET

接口地址​

/v1/perpum/fundingRate

频率限制​

该接口的调用频率限制为：每个 IP 和用户 ID 每秒最多请求8次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数​

参数必填类型描述
instrumenttrueString交易品种的基础货币。（例如，btc）。此参数区分大小写。

响应参数​

参数类型描述
dataBigDecimal资金费率

请求示例​

以下Python代码展示了如何获取BTC的当前资金费率。

注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

api_url = "/v1/perpum/fundingRate"              
params = { "instrument": "btc" } 
         
FuturesRestfulPublic(api_url, params)     # function FuturesRestfulPublic() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface)

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

响应示例​

以下是上述Python请求返回的示例响应：

{
'code': 0, 
'data': 
  {'value': 2.964e-05}, 
'msg': ''
}