概览OKX.AI钱包支付交易行情Exchange OSX Layer
開發者平臺
主題
概览
介绍
用户引导
链网络与基础设施
交易场所
支持市場
产品核心概念
账户
市场与交易产品
价格
订单与交易
保证金、清算与风险
费用
Open API
快速开始
API 参考
Open API 全局约定
订单改撤单规则
交易API 參考
账户API 参考
行情API参考
WebSocket
SDK
错误码
支持
Open API

行情API#

行情接口#

行情接口为公开接口，无需认证。价格、数量和时间戳均以字符串返回；时间戳为 Unix epoch 毫秒。

产品列表 GET /market/instruments#

聚合 Perps 与 Spot 产品：每个 Perps 合约占一行，每个 Spot 币对占一行。

同一个 assetId 可能对应多条生命周期记录，应结合 name 和 state 区分具体产品。

assetId 和 marketType 不可同时传入，否则返回 ILLEGAL_PARAMETER。

请求参数

参数类型必填说明
assetIdString否按产品 ID 过滤。不可与 marketType 同时传入。
marketTypeString否按市场类型过滤。不可与 assetId 同时传入。可取值为 perp 或 spot。

请求示例

text
GET /api/v5/exchangeos/market/instruments?assetId=0

响应字段

字段类型说明
assetIdString产品 ID。
marketTypeString市场类型：perp 或 spot。
nameString产品名称。
ulyString标的指数名称。
priceDecimalsString价格精度。
sizeDecimalsString数量精度。
buyLmtString当前最高买价限制。
sellLmtString当前最低卖价限制。
stateString产品状态。
settleTokenIdStringPerps 结算 Token ID；Spot 返回空字符串。
listTimeString当前生命周期上线时间，Unix 毫秒时间戳。
expTimeString当前生命周期下线时间，Unix 毫秒时间戳；未下线时返回空字符串。
upcChgArray即将生效的参数变更列表。
> paramString即将变更的参数名称。
> newValueString参数生效后的新值。
> effTimeString参数生效时间，Unix 毫秒时间戳。
leverageString最大杠杆倍数；Spot 返回空字符串。
positionTierIdString仓位梯度档位 ID；Spot 返回空字符串。
marginModesArray支持的保证金模式；Spot 返回空数组。
baseTokenIdStringSpot 基础币 Token ID；Perps 返回空字符串。
quoteTokenIdStringSpot 计价币 Token ID；Perps 返回空字符串。

upcChg.param 枚举

值说明
priceDecimals价格精度变更。
sizeDecimals数量精度变更。

响应示例：perp

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "102",
      "marketType": "perp",
      "name": "BTC",
      "uly": "BTC-USD",
      "priceDecimals": "1",
      "sizeDecimals": "5",
      "buyLmt": "99060.0",
      "sellLmt": "91340.0",
      "state": "live",
      "settleTokenId": "0",
      "listTime": "1710000000000",
      "expTime": "",
      "upcChg": [],
      "leverage": "100",
      "positionTierId": "3",
      "marginModes": [
        "cross",
        "isolated"
      ],
      "baseTokenId": "",
      "quoteTokenId": ""
    }
  ]
}

响应示例：spot

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "10001",
      "marketType": "spot",
      "name": "BTC/USDC",
      "uly": "BTC",
      "priceDecimals": "1",
      "sizeDecimals": "8",
      "buyLmt": "99900.0",
      "sellLmt": "90400.0",
      "state": "live",
      "settleTokenId": "",
      "listTime": "1710000000000",
      "expTime": "",
      "upcChg": [],
      "leverage": "",
      "positionTierId": "",
      "marginModes": [],
      "baseTokenId": "3",
      "quoteTokenId": "1"
    }
  ]
}

响应示例：perp 即将变更价格精度

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "1",
      "marketType": "perp",
      "name": "ETH",
      "uly": "ETH-USD",
      "priceDecimals": "2",
      "sizeDecimals": "4",
      "buyLmt": "3652.5",
      "sellLmt": "2988.5",
      "state": "live",
      "settleTokenId": "0",
      "listTime": "1710000000000",
      "expTime": "",
      "upcChg": [
        {
          "param": "priceDecimals",
          "newValue": "3",
          "effTime": "1710086400000"
        }
      ],
      "leverage": "25",
      "positionTierId": "5",
      "marginModes": [
        "cross",
        "isolated"
      ],
      "baseTokenId": "",
      "quoteTokenId": ""
    }
  ]
}

行情快照 GET /market/tickers#

一次获取某业务线所有产品的行情，包括最新成交、最优买卖价、24 小时 OHLC 和 24 小时成交量。

当 assetId 所属的 marketType 与传入的 marketType 冲突时，返回 ILLEGAL_PARAMETER。

无交易数据的字段返回空字符串。

请求参数

参数类型必填说明
assetIdString否按产品 ID 过滤。
marketTypeString否按市场类型过滤：perp 或 spot。

请求示例

text
GET /api/v5/exchangeos/market/tickers?marketType=perp

响应字段

字段类型说明
assetIdString产品 ID。
lastPxString最新成交价。
lastSzString最新成交数量。
askPxString最优卖价。
askSzString最优卖单数量。
bidPxString最优买价。
bidSzString最优买单数量。
open24hString24 小时开盘价。
high24hString24 小时最高价。
low24hString24 小时最低价。
vol24hString24 小时基础币成交量。
volCcy24hString24 小时计价币成交额。
sodUtc0StringUTC+0 日开盘价。
sodUtc8StringUTC+8 日开盘价。
tsString数据生成时间，Unix 毫秒时间戳。

响应示例：perp

vol24h 为基础币数量，volCcy24h 为 USDS 成交额。

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "102",
      "lastPx": "95200",
      "lastSz": "0.01",
      "askPx": "95201.0",
      "askSz": "1.2",
      "bidPx": "95199.0",
      "bidSz": "0.8",
      "open24h": "93000.0",
      "high24h": "96000.0",
      "low24h": "92500.0",
      "vol24h": "5980.23",
      "volCcy24h": "582310412.56",
      "sodUtc0": "93500.0",
      "sodUtc8": "94000.0",
      "ts": "1704067210000"
    }
  ]
}

响应示例：spot

vol24h 为基础币数量，volCcy24h 为计价币成交额。

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "10001",
      "lastPx": "95150.0",
      "lastSz": "0.005",
      "askPx": "95152.0",
      "askSz": "0.6",
      "bidPx": "95148.0",
      "bidSz": "0.9",
      "open24h": "92950.0",
      "high24h": "95900.0",
      "low24h": "92400.0",
      "vol24h": "812.45",
      "volCcy24h": "77216530.20",
      "sodUtc0": "93450.0",
      "sodUtc8": "93980.0",
      "ts": "1704067210000"
    }
  ]
}

订单簿 GET /market/order-book#

获取指定产品的买卖盘深度快照。数据源为 l2Book。

链上 RPC 不提供订单簿序列号。正确的本地订单簿维护方式为：

text
订阅 exchangeos-books
        ↓
收到 action=snapshot 和 seqId
        ↓
以快照建立本地订单簿
        ↓
仅应用 prevSeqId 等于上一笔 seqId 的 update
        ↓
序列不连续时重新订阅
  • REST GET /market/order-book 仅适合独立查询当前盘口。
  • WebSocket exchangeos-books 用于建立并持续维护完整的本地订单簿。

请求参数

参数类型必填说明
assetIdString是产品 ID。
depthString否返回的盘口深度。

请求示例

text
GET /api/v5/exchangeos/market/order-book?assetId=0&depth=20

响应字段

字段类型说明
asksArray卖盘档位数组，按价格从低到高排序。
bidsArray买盘档位数组，按价格从高到低排序。
> 0String档位价格。
> 1String该价格档位的数量。Perps 为基础币数量，不是张数。
> 2String该价格档位的订单数量。
tsString数据生成时间，Unix 毫秒时间戳。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "asks": [
        ["95200", "0.80", "2"],
        ["95205.0", "2.10", "5"]
      ],
      "bids": [
        ["95190.0", "1.20", "3"],
        ["95185.0", "0.50", "1"]
      ],
      "ts": "1704067210000"
    }
  ]
}

成交 K 线 GET /market/candles#

获取指定产品的 OHLCV K 线，用于绘图。响应为数组的数组，每根 K 线均为固定长度数组，而非对象。数据源为 candleSnapshot。

perp 与 spot 均以基础币计量。

请求参数

参数类型必填说明
assetIdString是产品 ID。
barString是K 线周期。
beginString否查询时间窗起点，Unix 毫秒时间戳。
endString否查询时间窗终点，Unix 毫秒时间戳。
limitString否返回的 K 线数量。

请求示例

text
GET /api/v5/exchangeos/market/candles?assetId=0&bar=1m&limit=100
GET /api/v5/exchangeos/market/candles?assetId=0&bar=1m&end=1704067200000&limit=100
GET /api/v5/exchangeos/market/candles?assetId=0&bar=1m&begin=1704000000000&end=1704067200000&limit=100

响应字段

data 中的每项均为固定长度的 9 元素字符串数组：

索引类型说明
0StringK 线开始时间，Unix 毫秒时间戳。
1String开盘价。
2String最高价。
3String最低价。
4String收盘价。
5String成交量，以基础币计量。
6String成交额。
7String成交额。
8StringK 线状态。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    ["1704067260000", "95100.0", "95250.0", "95080.0", "95200", "8.42", "800150.5", "800150.5", "1"],
    ["1704067200000", "95000.0", "95180.0", "94950.0", "95100.0", "7.63", "725000.2", "725000.2", "1"]
  ]
}

标记价 GET /market/mark-prices#

获取产品标记价，用于实时估值。仅支持 Perps；Spot 不返回 markPx。

请求参数

参数类型必填说明
assetIdString否产品 ID。

请求示例

text
GET /api/v5/exchangeos/market/mark-prices?assetId=0

响应字段

字段类型说明
assetIdString产品 ID。
markPxString标记价格。
tsString数据生成时间，Unix 毫秒时间戳。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "0",
      "markPx": "95200",
      "ts": "1704067210000"
    }
  ]
}

仓位梯度档位 GET /market/position-tiers#

仅支持 Perps 的公开接口。

梯度档位采用线性分段函数：MMR 和 IMR 在平底区间内，即仓位价值不超过 basePositionValue0 时，为常数；超过该值后，随仓位价值线性增加，每增加 100,000 USD 增加一个 changeRate。

接口返回合约默认档位。绑定特殊档位角色，例如 MM 或 VIP 的账户，应以私有接口 GET /account/position-tiers 返回的生效档位为准。

basePositionValue0、baseMMR0 和 baseIMR0 中的 0 表示保证金率曲线基准点，不代表 tiers[] 的第 0 条数据。tiers[] 为根据保证金率曲线计算出的杠杆与最大允许仓位对照表，两者语义不同。

请求参数

参数类型必填说明
assetIdString是Perps 产品 ID。

请求示例

text
GET /api/v5/exchangeos/market/position-tiers?assetId=102

计算公式

text
effectiveMMR(V) = baseMMR0 + max(0, (V − basePositionValue0) / 100000) × mmrChangeRate
effectiveIMR(V) = baseIMR0 + max(0, (V − basePositionValue0) / 100000) × imrChangeRate
维持保证金 MM = V × effectiveMMR(V)
theoreticalMaxPosition(L) = basePositionValue0 + (1/L − baseIMR0) × 100000 / imrChangeRate
  • V 为仓位价值，单位为 USD。即使 V 超过 maxPositionValue，费率仍按函数计算且不封顶；maxPositionValue 仅限制新开仓。
  • 开仓或加仓校验要求总仓位价值不超过所选杠杆对应的 maxPositionAllowed。
  • 在 hedge 模式下，梯度按账户、合约、保证金模式和仓位方向分别计算，多仓与空仓不合并计算。

响应字段

字段类型说明
assetIdString产品 ID。
positionTierIdString仓位梯度档位 ID。
basePositionValue0String保证金率曲线的基准仓位价值。
baseMMR0String基准维持保证金率。
baseIMR0String基准初始保证金率。
mmrChangeRateString维持保证金率变化率。
imrChangeRateString初始保证金率变化率。
maxPositionValueString最大仓位价值。
imrCurvePosValueGridString初始保证金率曲线仓位价值网格。
maxLeverageString最大杠杆倍数。
tiersArray杠杆与最大允许仓位对照表。
> leverageString杠杆倍数。
> maxPositionAllowedString该杠杆下允许的最大仓位价值。

响应示例

tiers 完整返回 1 至 100 档，以下为节选：

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "102",
      "positionTierId": "3",
      "basePositionValue0": "100000",
      "baseMMR0": "0.005",
      "baseIMR0": "0.01",
      "mmrChangeRate": "0.00025",
      "imrChangeRate": "0.0005",
      "maxPositionValue": "5000000",
      "imrCurvePosValueGrid": "10000",
      "maxLeverage": "100",
      "tiers": [
        {
          "leverage": "100",
          "maxPositionAllowed": "100000"
        },
        {
          "leverage": "50",
          "maxPositionAllowed": "2100000"
        },
        {
          "leverage": "2",
          "maxPositionAllowed": "5000000"
        },
        {
          "leverage": "1",
          "maxPositionAllowed": "5000000"
        }
      ]
    }
  ]
}

历史资金费率 GET /market/funding-rate-history#

获取指定产品的历史资金费率序列。每次资金费结算对应一条记录，最多返回最近一年的数据。

begin 和 end 用于时间窗过滤，cursor 用于续传。响应在 data[0] 中返回 nextCursor 和 hasMore。

分页规则

  • 记录位于 data[0].data，按 fundingTime 从新到旧返回。
  • 每页响应通过 data[0].nextCursor 返回下一页令牌。令牌为不透明值，客户端不得解析或自行构造。
  • 使用 data[0].hasMore 判断是否继续请求。hasMore=false 且 nextCursor="" 表示最后一页。
  • begin 和 end 仅用于时间窗过滤，不作为续传游标；当与 cursor 同时传入时，以 cursor 定位起点。
  • 首页不传 cursor。

请求参数

参数类型必填说明
assetIdString是Perps 产品 ID。
beginString否时间窗起点，Unix 毫秒时间戳。
endString否时间窗终点，Unix 毫秒时间戳。
cursorString否上一页返回的续传令牌。首页不传。
limitString否返回记录数量。

请求示例

text
GET /api/v5/exchangeos/market/funding-rate-history?assetId=0&limit=100
GET /api/v5/exchangeos/market/funding-rate-history?assetId=0&cursor=1&limit=100
GET /api/v5/exchangeos/market/funding-rate-history?assetId=0&begin=1704000000000&end=1704067200000&limit=100

响应字段

字段类型说明
nextCursorString下一页续传令牌；最后一页返回空字符串。
hasMoreBoolean是否仍有更多记录。
dataArray历史资金费率记录。
> assetIdString产品 ID。
> fundingRateString资金费率。
> fundingTimeString资金费结算时间，Unix 毫秒时间戳。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "nextCursor": "1",
      "hasMore": true,
      "data": [
        {
          "assetId": "0",
          "fundingRate": "0.0000125",
          "fundingTime": "1704067200000"
        },
        {
          "assetId": "0",
          "fundingRate": "0.0000095",
          "fundingTime": "1704038400000"
        }
      ]
    }
  ]
}

当期 / 预测资金费率 GET /market/funding-rate#

获取指定产品或全部产品在当前及下一结算周期的预测资金费率和相关参数。

资金费率公式如下：

text
fundingRate = clamp±maxFundingRate(
  multiplierFactor × (
    平均溢价指数 +
    clamp(interestRate − 平均溢价指数, ±damperValue)
  )
)

乘数在费率上限和下限截断前生效。溢价指数按 impactBaseNotional 深度加权计算。

fundingTime、interestRate、damperValue、multiplierFactor 和 impactBaseNotional 仅由 REST 接口提供，WebSocket 不推送。

请求参数

参数类型必填说明
assetIdString否Perps 产品 ID。不传时查询全部支持产品。

请求示例

text
GET /api/v5/exchangeos/market/funding-rate?assetId=0

响应字段

字段类型说明
assetIdString产品 ID。
fundingRateString当前或预测资金费率。
fundingTimeString当前资金费结算时间，Unix 毫秒时间戳。
nextFundingTimeString下一次资金费结算时间，Unix 毫秒时间戳。
settlementIntervalString结算间隔。
minFundingRateString最低资金费率。
maxFundingRateString最高资金费率。
interestRateString利率。
impactBaseNotionalString用于计算溢价指数的冲击基础名义价值。
damperValueString资金费率阻尼值。
multiplierFactorString资金费率乘数。
fundingSwitchBoolean资金费率开关状态。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "0",
      "fundingRate": "0.0000125",
      "fundingTime": "1704067200000",
      "nextFundingTime": "1704096000000",
      "settlementInterval": "8",
      "minFundingRate": "-0.0075",
      "maxFundingRate": "0.0075",
      "interestRate": "0.0001",
      "impactBaseNotional": "20000",
      "damperValue": "0.0005",
      "multiplierFactor": "1",
      "fundingSwitch": true
    }
  ]
}

持仓总量 GET /market/open-interest#

获取 Perps 合约市场的持仓总量。仅支持 Perps。

请求参数

参数类型必填说明
assetIdString否Perps 产品 ID。

请求示例

text
GET /api/v5/exchangeos/market/open-interest?assetId=102

响应字段

字段类型说明
assetIdString产品 ID。
oiCcyString以基础币计量的持仓总量。
oiUsdString以 USD 计量的持仓总量。
tsString数据生成时间，Unix 毫秒时间戳。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "102",
      "oiCcy": "22161.13",
      "oiUsd": "1939251795.54",
      "ts": "1704067210000"
    }
  ]
}

限价 GET /market/price-limit#

查询产品当前最高买价和最低卖价。接口返回按当前基准价换算的实时限价；委托价格越限时，priceAmendType=noAmend 将拒绝该订单。

适用于状态为 live 的 Perps 和 Spot 产品。

如果在线产品的 Oracle 尚未提供价格带，接口仍成功返回，buyLmt 和 sellLmt 返回空字符串 ""。空字符串表示当前无此值，不等于 "0"；客户端不得将其解释为零或无限制。

若 assetId 不存在，或该 assetId 的所有版本均已下线，即 state=expired 或 offline，返回 80208 ASSET_NOT_FOUND。已下线产品仍可能出现在 GET /market/instruments 返回列表中。

请求参数

参数类型必填说明
assetIdString是产品 ID。

请求示例

text
GET /api/v5/exchangeos/market/price-limit?assetId=102

响应字段

字段类型说明
assetIdString产品 ID。
buyLmtString当前最高买价限制；无价格带时返回空字符串。
sellLmtString当前最低卖价限制；无价格带时返回空字符串。
tsString数据生成时间，Unix 毫秒时间戳。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "102",
      "buyLmt": "99060.0",
      "sellLmt": "91340.0",
      "ts": "1704067210000"
    }
  ]
}

指数行情 GET /market/index-tickers#

获取指数最新价格与 24 小时统计数据。仅支持 Perps；指数用于 Perps 标记价和风控。

Trigger 订单中 triggerPriceType=index 的定价源即为本接口对应的指数。

请求参数

参数类型必填说明
assetIdString否Perps 产品 ID。

请求示例

text
GET /api/v5/exchangeos/market/index-tickers?assetId=102

响应字段

字段类型说明
assetIdString产品 ID。
ulyString标的指数名称。
idxPxString指数最新价格。
open24hString24 小时开盘价。
high24hString24 小时最高价。
low24hString24 小时最低价。
sodUtc0StringUTC+0 日开盘价。
sodUtc8StringUTC+8 日开盘价。
tsString数据生成时间，Unix 毫秒时间戳。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "assetId": "102",
      "uly": "BTC-USD",
      "idxPx": "95180.4",
      "open24h": "93010.2",
      "high24h": "96020.0",
      "low24h": "92480.9",
      "sodUtc0": "93510.0",
      "sodUtc8": "94012.3",
      "ts": "1704067210000"
    }
  ]
}

Token 基础资料 GET /market/token-info#

查询 ExchangeOS 支持的全部 Token 基础资料，用于建立 tokenId 与 Token 名称的映射，并判断 Token 是否为积分盘资产。

本接口为公开行情接口，无需认证，固定返回全部 Token。

请求参数

无。

请求示例

text
GET /api/v5/exchangeos/market/token-info

响应字段

字段类型说明
tokenIdStringToken ID。
tokenNameStringToken 名称。
pointFlagBoolean是否为积分盘资产。
weiDecimalsStringToken 最小单位精度。

响应示例

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "tokenId": "0",
      "tokenName": "USDS",
      "pointFlag": false,
      "weiDecimals": "6"
    },
    {
      "tokenId": "1",
      "tokenName": "POINTS",
      "pointFlag": true,
      "weiDecimals": "6"
    },
    {
      "tokenId": "3",
      "tokenName": "BTC",
      "pointFlag": false,
      "weiDecimals": "8"
    }
  ]
}

安全基金 GET /market/security-fund#

获取指定 Security Vault、Security Fund 或 Supplementary Fund 的最新价值及最近 7 天的每日快照。

如果指定基金配置为不展示，接口仍返回对应的 fundType 和 assetId，但 fundValue 与 block_timestamp 返回空字符串，history 返回空数组。

历史数据展示规则

Security Fund 的历史数据必须根据请求的 assetId 独立计算展示起点：

text
effectiveStartTime = max(准备金上线时间, 合约当前生命周期上线时间)
  • 每个 assetId 独立计算 effectiveStartTime。合约重新上架时，使用当前生命周期的上线时间，不返回旧生命周期的数据；共享同一 Fund 的其他合约不受影响。
  • 仅返回最近 7 天且 cTime >= effectiveStartTime 的每日快照。每天最多一条，按时间倒序排列。
  • fundValue 与 block_timestamp 取 cTime >= effectiveStartTime 的最新快照。没有符合条件的快照时，均返回空字符串，history 返回空数组。
  • Security Vault 和 Supplementary Fund 不绑定 assetId，以各自准备金上线时间为起点，返回最近 7 天快照。

HTTP 请求

text
GET /api/v5/exchangeos/market/security-fund

请求示例

查询 Security Vault：

text
GET /api/v5/exchangeos/market/security-fund?fundType=securityVault

查询指定资产的 Security Fund：

text
GET /api/v5/exchangeos/market/security-fund?fundType=securityFund&assetId=2

查询 Supplementary Fund：

text
GET /api/v5/exchangeos/market/security-fund?fundType=supplementaryFund

请求参数

参数类型必填说明
fundTypeString是基金类型：securityVault、securityFund 或 supplementaryFund。
assetIdString条件必填公共永续合约资产 ID。fundType=securityFund 时必填；其他基金类型不传。

响应参数

参数类型说明
assetIdStringSecurity Fund 对应的公共永续合约资产 ID。查询 Security Vault 或 Supplementary Fund 时返回空字符串。
fundTypeString基金类型：securityVault、securityFund 或 supplementaryFund。
fundValueString指定基金的最新价值，单位为 USD。基金不展示或无可用数据时返回空字符串。
block_timestampString最新基金价值的快照时间，Unix 毫秒时间戳。基金不展示或无可用数据时返回空字符串。
historyArray最近 7 天的每日基金价值快照，每天最多一条，按时间倒序排列。基金不展示或无可用数据时返回空数组。
> cTimeString历史快照生成时间，Unix 毫秒时间戳。
> balanceString历史快照时间点的基金价值，单位为 USD。

响应示例：Security Fund

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "data": [
        {
          "assetId": "2",
          "fundType": "securityFund",
          "fundValue": "12000.50",
          "block_timestamp": "1786636800000",
          "history": [
            {
              "cTime": "1786636800000",
              "balance": "12000.50"
            },
            {
              "cTime": "1786550400000",
              "balance": "11875.25"
            },
            {
              "cTime": "1786464000000",
              "balance": "11750.00"
            },
            {
              "cTime": "1786377600000",
              "balance": "11680.50"
            },
            {
              "cTime": "1786291200000",
              "balance": "11590.00"
            },
            {
              "cTime": "1786204800000",
              "balance": "11450.75"
            },
            {
              "cTime": "1786118400000",
              "balance": "11320.00"
            }
          ]
        }
      ]
    }
  ]
}

响应示例：Supplementary Fund 有值

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "data": [
        {
          "assetId": "",
          "fundType": "supplementaryFund",
          "fundValue": "486400.00",
          "block_timestamp": "1786636800000",
          "history": [
            {
              "cTime": "1786636800000",
              "balance": "486400.00"
            },
            {
              "cTime": "1786550400000",
              "balance": "480000.00"
            },
            {
              "cTime": "1786464000000",
              "balance": "475000.00"
            },
            {
              "cTime": "1786377600000",
              "balance": "470000.00"
            },
            {
              "cTime": "1786291200000",
              "balance": "465000.00"
            },
            {
              "cTime": "1786204800000",
              "balance": "460000.00"
            },
            {
              "cTime": "1786118400000",
              "balance": "455000.00"
            }
          ]
        }
      ]
    }
  ]
}

响应示例：基金不展示

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "data": [
        {
          "assetId": "",
          "fundType": "securityVault",
          "fundValue": "",
          "block_timestamp": "",
          "history": []
        }
      ]
    }
  ]
}

响应示例：重新上线且数据不足 7 天

假设 assetId="2" 本次上线时间为 1786464000000，仅返回当前生命周期内的 3 条快照：

json
{
  "code": "0",
  "msg": "",
  "data": [
    {
      "data": [
        {
          "assetId": "2",
          "fundType": "securityFund",
          "fundValue": "12000.50",
          "block_timestamp": "1786636800000",
          "history": [
            {
              "cTime": "1786636800000",
              "balance": "12000.50"
            },
            {
              "cTime": "1786550400000",
              "balance": "11875.25"
            },
            {
              "cTime": "1786464000000",
              "balance": "11750.00"
            }
          ]
        }
      ]
    }
  ]
}
目錄