> ## 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 latest price

> Retrieve the latest reference price in USD for an asset. Reference prices are not executable quotes.

price is null only when the provider explicitly reports no price. Provider unavailability or an invalid response is not treated as no price. No query parameters are accepted.


```json 200
{
  "asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
  "symbol": "AAPL",
  "currency": "USD",
  "price": "343.245"
}
```


## OpenAPI

````yaml /stocks/stocks.yaml get /v1/stocks/asset/{asset_id}/price
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
    description: Sandbox base URL.
  - url: https://api.uqpay.com/api
    description: Production base URL.
security:
  - AuthToken: []
paths:
  /v1/stocks/asset/{asset_id}/price:
    get:
      tags:
        - Stocks
      summary: Retrieve latest price
      description: >
        Retrieve the latest reference price in USD for an asset. Reference
        prices are not executable quotes.


        price is null only when the provider explicitly reports no price.
        Provider unavailability or an invalid response is not treated as no
        price. No query parameters are accepted.
      operationId: getStocksPrice
      parameters:
        - $ref: '#/components/parameters/XOnBehalfOf'
        - 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/AssetPrice'
              examples:
                sandbox:
                  summary: Sandbox response
                  value:
                    asset_id: 7453f146-b267-11f1-b4f4-0abd773ba497
                    symbol: AAPL
                    currency: USD
                    price: '343.245'
components:
  parameters:
    XOnBehalfOf:
      in: header
      name: x-on-behalf-of
      required: false
      schema:
        type: string
      description: >-
        Specifies the sub-account on whose behalf the request is made. Set it to
        the target sub-account account_id (a full lowercase UUID). If omitted or
        empty, the authenticated account is used. Requests, quotes, orders, and
        positions belong to the effective account. See [Sub-account
        requests](/stocks/guide/integration#subaccount-requests).
  schemas:
    AssetPrice:
      type: object
      additionalProperties: false
      properties:
        asset_id:
          type: string
          format: uuid
          description: >-
            Asset identifier shared by asset, quote, order, and position
            requests.
        symbol:
          type: string
          description: Asset symbol.
        currency:
          type: string
          enum:
            - USD
          description: Reference price currency; remains USD when no price is available.
        price:
          type: string
          nullable: true
          pattern: ^[0-9]+(\.[0-9]+)?$
          description: >-
            Current reference price from the provider; null when unavailable,
            with no fallback to historical snapshots. This is not a guaranteed
            execution price.
      required:
        - asset_id
        - symbol
        - currency
        - price
  securitySchemes:
    AuthToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: >-
        The API Token provided by UQPAY. Enter the complete header value,
        including the `Bearer ` prefix.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.