V3 深度价格历史图#
当用户希望查看 V3 Pool 的流动性深度分布或历史价格走势时，使用此接口。传入投资品 ID、图表类型（深度图或价格历史图）和时间范围，返回对应的深度/价格数据列表，可用于绘制流动性分布图或价格 K 线图。仅适用于 V3 Pool 类型投资品。
URL：GET /api/v6/defi/product/depth-price/chart
请求参数#
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| investmentId | String | 是 | — | 投资品 ID（整型字符串） |
| chartType | String | 否 | DEPTH | 图表类型：DEPTH=深度图，PRICE=价格历史图 |
| timeRange | String | 否 | DAY | 仅 chartType=PRICE 的时候使用，时间范围：DAY=24h，WEEK=1W |
请求示例#
示例 1：查询深度图（默认，近 24h）#
GET /api/v6/defi/product/depth-price/chart?investmentId=1589649169示例 2：查询价格历史图（近 1 周）#
GET /api/v6/defi/product/depth-price/chart?investmentId=1589649169&chartType=PRICE&timeRange=WEEK响应参数#
返回 Array，每个元素结构如下：
| 字段 | 类型 | 说明 |
|---|---|---|
| tick | Integer | tick 索引（深度图有值，价格历史图为空） |
| liquidity | String | 该 tick 的流动性（深度图有值） |
| liquidityNet | String | 该 tick 的净流动性（深度图有值） |
| token0Price | String | 深度图：该 tick 对应的 token0 价格；价格历史图：该时间点的历史 token0 价格 |
| token1Price | String | 深度图：该 tick 对应的 token1 价格；价格历史图：该时间点的历史 token1 价格 |
| timestamp | Long | 时间戳（毫秒，仅价格历史图有值） |
响应示例#
深度图（chartType=DEPTH）#
Json
{
"code": 0,
"msg": "",
"data": [
{
"tick": -32932,
"liquidity": "1234567890123456",
"liquidityNet": "500000000000000",
"token0Price": "0.9985",
"token1Price": "1.0015"
},
{
"tick": -32931,
"liquidity": "1234567890123456",
"liquidityNet": "0",
"token0Price": "0.9986",
"token1Price": "1.0014"
}
]
}
价格历史图（chartType=PRICE）#
Json
{
"code": 0,
"msg": "",
"data": [
{
"token0Price": "0.9985",
"token1Price": "1.0015",
"timestamp": 1741737600000
},
{
"token0Price": "0.9990",
"token1Price": "1.0010",
"timestamp": 1741651200000
}
]
}
错误示例：非 V3 Pool 投资品#
Json
{
"code": 84032,
"msg": "This api is only supported for V3 DEX Pool products",
"data": null
}