> ## 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.
# Retrieve price history
> Retrieve reference price samples for the selected asset and time window. These prices are not executable quotes.
```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 /stocks/stocks.yaml get /asset/{asset_id}/price-history
openapi: 3.0.3
info:
title: UQPAY Stocks API
version: 1.0.0
description: >-
Browse assets, request quotes, create orders, and query orders and
positions. Amounts and quantities use decimal strings.
servers:
- url: https://api-sandbox.uqpaytech.com/api/v1/stocks
description: Sandbox
security:
- AuthToken: []
paths:
/asset/{asset_id}/price-history:
get:
tags:
- Stocks
summary: Retrieve price history
description: >-
Retrieve reference price samples for the selected asset and time window.
These prices are not executable quotes.
operationId: getStocksPriceHistory
parameters:
- name: range
in: query
required: false
schema:
type: string
enum:
- 1d
- 1w
- 1m
default: 1d
description: Reference-price history window.
- name: asset_id
in: path
required: true
schema:
type: string
format: uuid
description: Asset identifier returned by List assets.
example: 7453f146-b267-11f1-b4f4-0abd773ba497
responses:
'200':
description: Success
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: >-
The request failed. Read type, code, and message in the error
response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: >-
The request failed. Read type, code, and message in the error
response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: >-
The request failed. Read type, code, and message in the error
response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: >-
The request failed. Read type, code, and message in the error
response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: >-
The request failed. Read type, code, and message in the error
response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: >-
The request failed. Read type, code, and message in the error
response.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: >-
The gateway could not complete the request. For a write, reconcile
the result before retrying with the same idempotency key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: >-
The request failed. Read type, code, and message in the error
response.
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: >-
Asset identifier used across asset, quote, order, and position
requests.
example: 7453f146-b267-11f1-b4f4-0abd773ba497
symbol:
type: string
description: Asset symbol.
example: AAPLx
range:
type: string
enum:
- 1d
- 1w
- 1m
description: Time window covered by the returned price samples.
example: 1d
currency:
type: string
description: Price currency.
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: >-
Reference price samples within the requested window. Prices are not
guaranteed execution prices.
required:
- asset_id
- symbol
- range
- currency
- points
Error:
type: object
additionalProperties: false
required:
- type
- code
- message
properties:
type:
type: string
description: Error category for classifying the failure.
pattern: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
code:
type: string
description: >-
Machine-readable business error code. Use this together with the
HTTP status; do not match on message text.
pattern: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$
message:
type: string
description: Human-readable explanation of the error.
securitySchemes:
AuthToken:
type: apiKey
in: header
name: x-auth-token
description: The API token for login provided by UQPAY.
````