Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
接口文档
经典理财
    鲨鱼鳍
      鲨鱼鳍产品列表get鲨鱼鳍账户信息get鲨鱼鳍资产信息get鲨鱼鳍历史记录get鲨鱼鳍申购详情get鲨鱼鳍申购post鲨鱼鳍申购结果get
经典理财 · 鲨鱼鳍
经典理财 · 鲨鱼鳍

鲨鱼鳍

经典账户 — 鲨鱼鳍


鲨鱼鳍产品列表

GET
https://api.bitget.com
/api/v2/earn/sharkfin/product

限频规则: 10次/秒/UID

获取鲨鱼鳍产品列表。

鲨鱼鳍产品列表 › Request Parameters

coin
​string · required

币种

limit
​string

查询条数

默认20,最大100

idLessThan
​string

请求此ID之后(更新的数据)的分页内容,传的值为对应接口的 endId

鲨鱼鳍产品列表 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

鲨鱼鳍产品信息

endId
​string

分页结束ID

GET/api/v2/earn/sharkfin/product
curl 'https://api.bitget.com/api/v2/earn/sharkfin/product?coin=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696754489003, "data": { "resultList": [ { "productId": "1", "productName": "USDT/ETH_20231009", "productCoin": "ETH", "subscribeCoin": "USDT", "farmingStartTime": "1696744800000", "farmingEndTime": "1696831200000", "lowerRate": "7.06", "defaultRate": "7", "upperRate": "8.8", "period": "7", "interestStartTime": "1696838400000", "status": "in_progress", "minAmount": "0.1", "limitAmount": "500001.0", "soldAmount": "310187.2", "endTime": "1696831200000", "startTime": "1696744800000" } ], "endId": "1" } }
json
application/json

鲨鱼鳍账户信息

GET
https://api.bitget.com
/api/v2/earn/sharkfin/account

限频规则: 10次/秒/UID

获取鲨鱼鳍账户信息。

鲨鱼鳍账户信息 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
btcSubscribeAmount
​string

BTC计价的预估资产总值

usdtSubscribeAmount
​string

USDT计价的预估资产总值

btcHistoricalAmount
​string

BTC计价的24小时收益

usdtHistoricalAmount
​string

USDT计价的24小时收益

btcTotalEarning
​string

BTC计价的累计收益

usdtTotalEarning
​string

USDT计价的累计收益

GET/api/v2/earn/sharkfin/account
curl https://api.bitget.com/api/v2/earn/sharkfin/account
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696755312297, "data": { "btcSubscribeAmount": "0.00000000", "usdtSubscribeAmount": "0.00", "btcHistoricalAmount": "0.00000000", "usdtHistoricalAmount": "0.00000000", "btcTotalEarning": "0.00000000", "usdtTotalEarning": "0.00000000" } }
json
application/json

鲨鱼鳍资产信息

GET
https://api.bitget.com
/api/v2/earn/sharkfin/assets

限频规则: 10次/秒/UID

获取鲨鱼鳍资产信息。

鲨鱼鳍资产信息 › Request Parameters

status
​string · required

鲨鱼鳍状态

subscribed 已申购(默认)

settled 已结算

startTime
​string

开始时间戳

(跟单创建时间)

Unix时间戳的毫秒数格式,如 1597026383085

(时间跨度最大支持三个月,若不传结束时间,则默认结束时间为三个月。)

endTime
​string

结束时间戳

(跟单创建时间)

Unix时间戳的毫秒数格式,如 1597026383085

(时间跨度最大支持三个月,若不传开始时间,则默认开始时间为三个月。)

limit
​string

查询条数

默认20,最大100

idLessThan
​string

请求此ID之后(更新的数据)的分页内容,传的值为对应接口的 endId

鲨鱼鳍资产信息 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

鲨鱼鳍产品信息

endId
​string

分页结束ID

GET/api/v2/earn/sharkfin/assets
curl 'https://api.bitget.com/api/v2/earn/sharkfin/assets?status=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696756316611, "data": { "resultList": [ { "productId": "12312313", "interestStartTime": "1697199180000", "interestEndTime": "1697803980000", "productCoin": "BTC", "subscribeCoin": "USDT", "trend": "up", "settleTime": "1697803980000", "interestAmount": "", "productStatus": "running" } ], "endId": "456456456" } }
json
application/json

鲨鱼鳍历史记录

GET
https://api.bitget.com
/api/v2/earn/sharkfin/records

限频规则: 10次/秒/UID

获取鲨鱼鳍历史记录。

鲨鱼鳍历史记录 › Request Parameters

type
​string · required

交易类型

subscription 申购

redemption 赎回

interest 利息派付

coin
​string

申购币种

startTime
​string

开始时间戳

Unix时间戳的毫秒数格式,如 1597026383085

(时间跨度最大支持三个月,若不传结束时间,则默认结束时间为三个月。)

endTime
​string

结束时间戳

Unix时间戳的毫秒数格式,如 1597026383085

(时间跨度最大支持三个月,若不传开始时间,则默认开始时间为三个月。)

limit
​string

查询条数

默认20,最大100

idLessThan
​string

请求此ID之后(更新的数据)的分页内容,传的值为对应接口的 endId

鲨鱼鳍历史记录 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

记录列表

endId
​string

分页结束ID

GET/api/v2/earn/sharkfin/records
curl 'https://api.bitget.com/api/v2/earn/sharkfin/records?type=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696757048457, "data": { "resultList": [ { "orderId": "1", "product": "USDT/BTC_20231013", "period": "7", "amount": "100.00000000", "ts": "1696756278760", "type": "subscription" } ], "endId": "1" } }
json
application/json

鲨鱼鳍申购详情

GET
https://api.bitget.com
/api/v2/earn/sharkfin/subscribe-info

限频规则: 10次/秒/UID

获取鲨鱼鳍申购详情。

鲨鱼鳍申购详情 › Request Parameters

productId
​string · required

产品Id

鲨鱼鳍申购详情 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
productCoin
​string

产品币种

subscribeCoin
​string

申购币种

interestTime
​string

起息日期 Unix时间戳的毫秒数格式

expirationTime
​string

结算时间 Unix时间戳的毫秒数格式

minPrice
​string

价格区间的最小价格

currentPrice
​string

当前价格

maxPrice
​string

价格区间的最大价格

minRate
​string

派费率最小值

defaultRate
​string

费率默认值

maxRate
​string

费率最大值

period
​string

投资期限

productMinAmount
​string

产品最小限额

availableBalance
​string

可用余额

userAmount
​string

单人额度

remainingAmount
​string

剩余额度

profitPrecision
​string

计息精度

subscribePrecision
​string

申购金额精度

GET/api/v2/earn/sharkfin/subscribe-info
curl 'https://api.bitget.com/api/v2/earn/sharkfin/subscribe-info?productId=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696757209022, "data": { "productCoin": "BTC", "subscribeCoin": "USDT", "interestTime": "1697199180000", "expirationTime": "1697803980000", "minPrice": "28000.00", "currentPrice": "30211.23", "maxPrice": "32000.00", "minRate": "5.00", "defaultRate": "1.00", "maxRate": "20.00", "period": "7", "productMinAmount": "0.00100000", "availableBalance": "788", "userAmount": "500.00000000", "remainingAmount": "400.00000000", "profitPrecision": "8", "subscribePrecision": "8" } }
json
application/json

鲨鱼鳍申购

POST
https://api.bitget.com
/api/v2/earn/sharkfin/subscribe

限频规则: 10次/秒/UID

鲨鱼鳍申购。

鲨鱼鳍申购 › Request Parameters

productId
​string · required

产品Id

amount
​string · required

申购金额

鲨鱼鳍申购 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
orderId
​string

申购成功订单Id

status
​string

订单状态

POST/api/v2/earn/sharkfin/subscribe
curl https://api.bitget.com/api/v2/earn/sharkfin/subscribe \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "productId": "productId", "amount": "amount" }'
Example Request Body
{ "productId": "productId", "amount": "amount" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696751519392, "data": { "orderId": "123123123", "status": "2000.000000" } }
json
application/json

鲨鱼鳍申购结果

GET
https://api.bitget.com
/api/v2/earn/sharkfin/subscribe-result

限频规则: 5次/秒/UID

获取鲨鱼鳍申购结果。

鲨鱼鳍申购结果 › Request Parameters

orderId
​string · required

订单Id

鲨鱼鳍申购结果 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
result
​string

申购是否成功

success 成功

fail 失败

msg
​string

只有失败时才会返回信息

GET/api/v2/earn/sharkfin/subscribe-result
curl 'https://api.bitget.com/api/v2/earn/sharkfin/subscribe-result?orderId=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1696752594890, "data": { "result": "success", "msg": "" } }
json
application/json