> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 查询历史价格
> 查询指定资产和时间范围的参考价格采样。这些价格不是可直接成交的报价。
```bash cURL
curl --request GET \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/asset/7453f146-b267-11f1-b4f4-0abd773ba497/price-history' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
```
```json 200
{
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"currency": "USD",
"points": [
{
"price": "334.815",
"time": "2026-09-19T00:00:00Z"
},
{
"price": "335.335",
"time": "2026-09-21T00:06:00Z"
},
{
"price": "335.155",
"time": "2026-09-21T00:07:00Z"
},
{
"price": "335.12",
"time": "2026-09-21T00:08:00Z"
},
{
"price": "335.15",
"time": "2026-09-21T00:09:00Z"
},
{
"price": "335.05",
"time": "2026-09-21T00:10:00Z"
},
{
"price": "335.07",
"time": "2026-09-21T00:11:00Z"
},
{
"price": "335.2",
"time": "2026-09-21T00:12:00Z"
},
{
"price": "335.21",
"time": "2026-09-21T00:13:00Z"
},
{
"price": "335.2",
"time": "2026-09-21T00:14:00Z"
},
{
"price": "335.2",
"time": "2026-09-21T00:15:00Z"
},
{
"price": "335.225",
"time": "2026-09-21T00:16:00Z"
},
{
"price": "335.155",
"time": "2026-09-21T00:17:00Z"
},
{
"price": "335.2",
"time": "2026-09-21T00:18:00Z"
},
{
"price": "335.455",
"time": "2026-09-21T00:19:00Z"
},
{
"price": "335.3",
"time": "2026-09-21T00:20:00Z"
},
{
"price": "335.29",
"time": "2026-09-21T00:21:00Z"
},
{
"price": "335.29",
"time": "2026-09-21T00:22:00Z"
},
{
"price": "335.255",
"time": "2026-09-21T00:23:00Z"
},
{
"price": "335.255",
"time": "2026-09-21T00:24:00Z"
},
{
"price": "335.175",
"time": "2026-09-21T00:25:00Z"
},
{
"price": "335.13",
"time": "2026-09-21T00:26:00Z"
},
{
"price": "335.13",
"time": "2026-09-21T00:27:00Z"
},
{
"price": "335.13",
"time": "2026-09-21T00:28:00Z"
},
{
"price": "335.13",
"time": "2026-09-21T00:29:00Z"
},
{
"price": "335.13",
"time": "2026-09-21T00:30:00Z"
},
{
"price": "335.125",
"time": "2026-09-21T00:31:00Z"
},
{
"price": "335.125",
"time": "2026-09-21T00:32:00Z"
},
{
"price": "335.095",
"time": "2026-09-21T00:33:00Z"
},
{
"price": "335.075",
"time": "2026-09-21T00:34:00Z"
},
{
"price": "335.07",
"time": "2026-09-21T00:35:00Z"
},
{
"price": "335.075",
"time": "2026-09-21T00:36:00Z"
},
{
"price": "335",
"time": "2026-09-21T00:37:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:38:00Z"
},
{
"price": "334.94",
"time": "2026-09-21T00:39:00Z"
},
{
"price": "335.025",
"time": "2026-09-21T00:40:00Z"
},
{
"price": "335.03",
"time": "2026-09-21T00:41:00Z"
},
{
"price": "335.065",
"time": "2026-09-21T00:42:00Z"
},
{
"price": "334.935",
"time": "2026-09-21T00:43:00Z"
},
{
"price": "335",
"time": "2026-09-21T00:44:00Z"
},
{
"price": "335",
"time": "2026-09-21T00:45:00Z"
},
{
"price": "335.005",
"time": "2026-09-21T00:46:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:47:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:48:00Z"
},
{
"price": "335.035",
"time": "2026-09-21T00:49:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:50:00Z"
},
{
"price": "335.015",
"time": "2026-09-21T00:51:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:52:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:53:00Z"
},
{
"price": "335.045",
"time": "2026-09-21T00:54:00Z"
},
{
"price": "334.97",
"time": "2026-09-21T00:55:00Z"
},
{
"price": "334.94",
"time": "2026-09-21T00:56:00Z"
},
{
"price": "334.94",
"time": "2026-09-21T00:57:00Z"
},
{
"price": "334.94",
"time": "2026-09-21T00:58:00Z"
},
{
"price": "334.94",
"time": "2026-09-21T00:59:00Z"
},
{
"price": "335.07",
"time": "2026-09-21T01:00:00Z"
},
{
"price": "335.07",
"time": "2026-09-21T01:01:00Z"
},
{
"price": "335.075",
"time": "2026-09-21T01:02:00Z"
},
{
"price": "335.075",
"time": "2026-09-21T01:03:00Z"
},
{
"price": "335.075",
"time": "2026-09-21T01:04:00Z"
},
{
"price": "334.97",
"time": "2026-09-21T01:05:00Z"
},
{
"price": "335.02",
"time": "2026-09-21T01:06:00Z"
},
{
"price": "334.96",
"time": "2026-09-21T01:07:00Z"
},
{
"price": "334.97",
"time": "2026-09-21T01:08:00Z"
},
{
"price": "334.96",
"time": "2026-09-21T01:09:00Z"
},
{
"price": "334.925",
"time": "2026-09-21T01:10:00Z"
},
{
"price": "334.85",
"time": "2026-09-21T01:11:00Z"
},
{
"price": "334.815",
"time": "2026-09-21T01:12:00Z"
},
{
"price": "334.755",
"time": "2026-09-21T01:13:00Z"
},
{
"price": "334.715",
"time": "2026-09-21T01:14:00Z"
},
{
"price": "334.94",
"time": "2026-09-21T01:15:00Z"
},
{
"price": "334.88",
"time": "2026-09-21T01:16:00Z"
},
{
"price": "334.875",
"time": "2026-09-21T01:17:00Z"
},
{
"price": "334.875",
"time": "2026-09-21T01:18:00Z"
},
{
"price": "334.87",
"time": "2026-09-21T01:19:00Z"
},
{
"price": "334.85",
"time": "2026-09-21T01:20:00Z"
},
{
"price": "334.875",
"time": "2026-09-21T01:21:00Z"
},
{
"price": "334.875",
"time": "2026-09-21T01:22:00Z"
},
{
"price": "334.865",
"time": "2026-09-21T01:23:00Z"
},
{
"price": "334.865",
"time": "2026-09-21T01:24:00Z"
},
{
"price": "334.92",
"time": "2026-09-21T01:25:00Z"
},
{
"price": "334.9",
"time": "2026-09-21T01:26:00Z"
},
{
"price": "334.795",
"time": "2026-09-21T01:27:00Z"
},
{
"price": "334.805",
"time": "2026-09-21T01:28:00Z"
},
{
"price": "334.865",
"time": "2026-09-21T01:29:00Z"
},
{
"price": "334.85",
"time": "2026-09-21T01:30:00Z"
}
],
"range": "1d",
"symbol": "AAPLx"
}
```
## OpenAPI
````yaml /zh/stocks/stocks.yaml get /asset/{asset_id}/price-history
openapi: 3.0.3
info:
title: UQPAY Stocks API
version: 1.0.0
description: 浏览资产、获取报价、创建订单并查询订单及持仓。金额和数量使用十进制字符串。
x-source-en-commit: 586409f
x-source-en-path: stocks/stocks.yaml
servers:
- url: https://api-sandbox.uqpaytech.com/api/v1/stocks
description: Sandbox
security:
- AuthToken: []
paths:
/asset/{asset_id}/price-history:
get:
tags:
- Stocks
summary: 查询历史价格
description: 查询指定资产和时间范围的参考价格采样。这些价格不是可直接成交的报价。
operationId: getStocksPriceHistory
parameters:
- name: range
in: query
required: false
schema:
type: string
enum:
- 1d
- 1w
- 1m
default: 1d
description: 参考价格历史的时间范围。
- name: asset_id
in: path
required: true
schema:
type: string
format: uuid
description: List assets 返回的资产标识。
example: 7453f146-b267-11f1-b4f4-0abd773ba497
responses:
'200':
description: 成功
content:
application/json:
schema:
$ref: '#/components/schemas/PriceHistory'
examples:
sandbox:
summary: Sandbox response
value:
asset_id: 7453f146-b267-11f1-b4f4-0abd773ba497
currency: USD
points:
- price: '334.815'
time: '2026-09-19T00:00:00Z'
- price: '335.335'
time: '2026-09-21T00:06:00Z'
- price: '335.155'
time: '2026-09-21T00:07:00Z'
- price: '335.12'
time: '2026-09-21T00:08:00Z'
- price: '335.15'
time: '2026-09-21T00:09:00Z'
- price: '335.05'
time: '2026-09-21T00:10:00Z'
- price: '335.07'
time: '2026-09-21T00:11:00Z'
- price: '335.2'
time: '2026-09-21T00:12:00Z'
- price: '335.21'
time: '2026-09-21T00:13:00Z'
- price: '335.2'
time: '2026-09-21T00:14:00Z'
- price: '335.2'
time: '2026-09-21T00:15:00Z'
- price: '335.225'
time: '2026-09-21T00:16:00Z'
- price: '335.155'
time: '2026-09-21T00:17:00Z'
- price: '335.2'
time: '2026-09-21T00:18:00Z'
- price: '335.455'
time: '2026-09-21T00:19:00Z'
- price: '335.3'
time: '2026-09-21T00:20:00Z'
- price: '335.29'
time: '2026-09-21T00:21:00Z'
- price: '335.29'
time: '2026-09-21T00:22:00Z'
- price: '335.255'
time: '2026-09-21T00:23:00Z'
- price: '335.255'
time: '2026-09-21T00:24:00Z'
- price: '335.175'
time: '2026-09-21T00:25:00Z'
- price: '335.13'
time: '2026-09-21T00:26:00Z'
- price: '335.13'
time: '2026-09-21T00:27:00Z'
- price: '335.13'
time: '2026-09-21T00:28:00Z'
- price: '335.13'
time: '2026-09-21T00:29:00Z'
- price: '335.13'
time: '2026-09-21T00:30:00Z'
- price: '335.125'
time: '2026-09-21T00:31:00Z'
- price: '335.125'
time: '2026-09-21T00:32:00Z'
- price: '335.095'
time: '2026-09-21T00:33:00Z'
- price: '335.075'
time: '2026-09-21T00:34:00Z'
- price: '335.07'
time: '2026-09-21T00:35:00Z'
- price: '335.075'
time: '2026-09-21T00:36:00Z'
- price: '335'
time: '2026-09-21T00:37:00Z'
- price: '335.045'
time: '2026-09-21T00:38:00Z'
- price: '334.94'
time: '2026-09-21T00:39:00Z'
- price: '335.025'
time: '2026-09-21T00:40:00Z'
- price: '335.03'
time: '2026-09-21T00:41:00Z'
- price: '335.065'
time: '2026-09-21T00:42:00Z'
- price: '334.935'
time: '2026-09-21T00:43:00Z'
- price: '335'
time: '2026-09-21T00:44:00Z'
- price: '335'
time: '2026-09-21T00:45:00Z'
- price: '335.005'
time: '2026-09-21T00:46:00Z'
- price: '335.045'
time: '2026-09-21T00:47:00Z'
- price: '335.045'
time: '2026-09-21T00:48:00Z'
- price: '335.035'
time: '2026-09-21T00:49:00Z'
- price: '335.045'
time: '2026-09-21T00:50:00Z'
- price: '335.015'
time: '2026-09-21T00:51:00Z'
- price: '335.045'
time: '2026-09-21T00:52:00Z'
- price: '335.045'
time: '2026-09-21T00:53:00Z'
- price: '335.045'
time: '2026-09-21T00:54:00Z'
- price: '334.97'
time: '2026-09-21T00:55:00Z'
- price: '334.94'
time: '2026-09-21T00:56:00Z'
- price: '334.94'
time: '2026-09-21T00:57:00Z'
- price: '334.94'
time: '2026-09-21T00:58:00Z'
- price: '334.94'
time: '2026-09-21T00:59:00Z'
- price: '335.07'
time: '2026-09-21T01:00:00Z'
- price: '335.07'
time: '2026-09-21T01:01:00Z'
- price: '335.075'
time: '2026-09-21T01:02:00Z'
- price: '335.075'
time: '2026-09-21T01:03:00Z'
- price: '335.075'
time: '2026-09-21T01:04:00Z'
- price: '334.97'
time: '2026-09-21T01:05:00Z'
- price: '335.02'
time: '2026-09-21T01:06:00Z'
- price: '334.96'
time: '2026-09-21T01:07:00Z'
- price: '334.97'
time: '2026-09-21T01:08:00Z'
- price: '334.96'
time: '2026-09-21T01:09:00Z'
- price: '334.925'
time: '2026-09-21T01:10:00Z'
- price: '334.85'
time: '2026-09-21T01:11:00Z'
- price: '334.815'
time: '2026-09-21T01:12:00Z'
- price: '334.755'
time: '2026-09-21T01:13:00Z'
- price: '334.715'
time: '2026-09-21T01:14:00Z'
- price: '334.94'
time: '2026-09-21T01:15:00Z'
- price: '334.88'
time: '2026-09-21T01:16:00Z'
- price: '334.875'
time: '2026-09-21T01:17:00Z'
- price: '334.875'
time: '2026-09-21T01:18:00Z'
- price: '334.87'
time: '2026-09-21T01:19:00Z'
- price: '334.85'
time: '2026-09-21T01:20:00Z'
- price: '334.875'
time: '2026-09-21T01:21:00Z'
- price: '334.875'
time: '2026-09-21T01:22:00Z'
- price: '334.865'
time: '2026-09-21T01:23:00Z'
- price: '334.865'
time: '2026-09-21T01:24:00Z'
- price: '334.92'
time: '2026-09-21T01:25:00Z'
- price: '334.9'
time: '2026-09-21T01:26:00Z'
- price: '334.795'
time: '2026-09-21T01:27:00Z'
- price: '334.805'
time: '2026-09-21T01:28:00Z'
- price: '334.865'
time: '2026-09-21T01:29:00Z'
- price: '334.85'
time: '2026-09-21T01:30:00Z'
range: 1d
symbol: AAPLx
'400':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: 网关未能完成请求。写入操作应先核对结果，再使用同一幂等键重试。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: 请求失败。读取错误响应中的 type、code 和 message。
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
x-codeSamples:
- lang: cURL
source: |-
curl --request GET \
--url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/asset/7453f146-b267-11f1-b4f4-0abd773ba497/price-history' \
--header "Content-Type: application/json" \
--header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
components:
schemas:
PriceHistory:
type: object
additionalProperties: false
properties:
asset_id:
type: string
format: uuid
description: 平台资产 UUID，列表与所有交易接口共用
example: 7453f146-b267-11f1-b4f4-0abd773ba497
symbol:
type: string
description: 资产代码。
example: AAPLx
range:
type: string
enum:
- 1d
- 1w
- 1m
description: 返回价格采样覆盖的时间范围。
example: 1d
currency:
type: string
description: 行情报价币种
example: USD
points:
type: array
items:
type: object
additionalProperties: false
properties:
time:
type: string
format: date-time
example: '2026-09-19T00:00:00Z'
price:
type: string
pattern: ^-?[0-9]+(\.[0-9]+)?$
example: '334.815'
required:
- time
- price
description: 请求时间范围内的参考价格采样，不保证可按该价格成交。
required:
- asset_id
- symbol
- range
- currency
- points
Error:
type: object
additionalProperties: false
required:
- type
- code
- message
properties:
type:
type: string
description: 用于分类处理失败的错误类别。
pattern: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
code:
type: string
description: 可供程序处理的业务错误码。结合 HTTP 状态处理，不要依赖 message 文本匹配。
pattern: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
message:
type: string
description: 错误原因的可读说明。
securitySchemes:
AuthToken:
type: apiKey
in: header
name: x-auth-token
description: 由 UQPAY 提供的登录 API Token。
````