Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
理财
    链上精选 API
      获取链上精选产品列表get获取链上精选申购详情get链上精选申购post获取链上精选申购结果get获取链上精选赎回信息get链上精选赎回post获取链上精选资产信息get获取链上精选历史记录get
    现金宝
      获取现金宝申购详情get现金宝申购post获取现金宝申购结果get获取现金宝赎回详情get现金宝赎回post获取现金宝赎回结果get获取现金宝持仓get获取现金宝历史订单get
    理财宝
      理财宝产品列表get理财宝账户信息get理财宝资产信息get理财宝历史记录get理财宝申购详情get理财宝申购post理财宝申购结果get理财宝赎回post理财宝赎回结果get
    鲨鱼鳍
      鲨鱼鳍产品列表get鲨鱼鳍账户信息get鲨鱼鳍资产信息get鲨鱼鳍历史记录get鲨鱼鳍申购详情get鲨鱼鳍申购post鲨鱼鳍申购结果get
理财
理财

鲨鱼鳍

鲨鱼鳍


鲨鱼鳍产品列表

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

限频规则: 10次/秒/UID

获取鲨鱼鳍产品列表。

鲨鱼鳍产品列表 › Request Parameters

coin
​string · required

币种

limit
​string

查询条数

默认20,最大100

cursor
​string

游标ID

用于分页。首次调用不传。后续调用传入上次查询返回的最后一个endId

鲨鱼鳍产品列表 › Response Parameters

200

Successful response

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

鲨鱼鳍产品信息

productId
​string

产品Id

productName
​string

产品名称

productCoin
​string

产品申购币种

subscribeCoin
​string

派息币种

farmingStartTime
​string

开始时间,Unix毫秒时间戳

farmingEndTime
​string

停止时间,Unix毫秒时间戳

lowerRate
​string

费率最小值

defaultRate
​string

费率默认值

upperRate
​string

费率最大值

period
​string

投资期限

interestStartTime
​string

计息开始时间

status
​string

产品状态

not_started 预热中

in_progress 申购中

paused 已暂停

interest_pending 计息中

settle_pending 待结算

settled 已结算

redeemed 已赎回

sold_out 已售罄

minAmount
​string

产品最小限额

limitAmount
​string

产品额度

若无限制则返回 unlimited

soldAmount
​string

已售额度

startTime
​string

开始时间

Unix时间戳的毫秒数格式

endTime
​string

结束时间

Unix时间戳的毫秒数格式

endId
​string

分页结束ID

GET/api/v3/earn/sharkfin/product
curl 'https://api.bitget.com/api/v3/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/v3/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/v3/earn/sharkfin/account
curl https://api.bitget.com/api/v3/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/v3/earn/sharkfin/assets

限频规则: 10次/秒/UID

获取鲨鱼鳍资产信息。

鲨鱼鳍资产信息 › Request Parameters

status
​string · required

鲨鱼鳍状态

subscribed 已申购(默认)

settled 已结算

startTime
​string

开始时间戳

(跟单创建时间)

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

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

endTime
​string

结束时间戳

(跟单创建时间)

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

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

limit
​string

查询条数

默认20,最大100

cursor
​string

游标ID

用于分页。首次调用不传。后续调用传入上次查询返回的最后一个endId

鲨鱼鳍资产信息 › Response Parameters

200

Successful response

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

鲨鱼鳍产品信息

productId
​string

产品Id

interestStartTime
​string

计息开始时间

interestEndTime
​string

计息结束时间

productCoin
​string

产品申购币种

subscribeCoin
​string

派息币种

trend
​string

趋势

up 涨

down 跌

settleTime
​string

结算时间,Unix毫秒时间戳

interestAmount
​string

收益

productStatus
​string

产品状态

running 申购中

pause 已暂停

wait_interest 待起息

wait_settle 待结算

settle 已结算

redeem 已赎回

sell_out 已售罄

endId
​string

分页结束ID

GET/api/v3/earn/sharkfin/assets
curl 'https://api.bitget.com/api/v3/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/v3/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

cursor
​string

游标ID

用于分页。首次调用不传。后续调用传入上次查询返回的最后一个endId

鲨鱼鳍历史记录 › Response Parameters

200

Successful response

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

记录列表

orderId
​string

记录Id

product
​string

产品名称

period
​string

期限时长

amount
​string

金额

ts
​string

创建时间 时间戳

type
​string

交易类型

subscription 申购

redemption 赎回

interest 利息派付

endId
​string

分页结束ID

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

理财宝