> ## 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.

# 列出资产

> 列出当前账户可见的资产。请求报价前检查可用能力。

<RequestExample>
  ```bash cURL
  curl --request GET \
    --url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/asset' \
    --header "Content-Type: application/json" \
    --header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
  ```
</RequestExample>

<ResponseExample>
  ```json 200
  {
    "data": [
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
        "symbol": "AAPLx",
        "name": "Apple xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "334.85",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "896fa067-c017-40f4-9b72-4dde9732566f",
        "symbol": "ACNx",
        "name": "Accenture xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "193.3",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "54f913d6-eeb9-47c8-aa94-3d9fa1fd9304",
        "symbol": "ADBEx",
        "name": "Adobe xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "249.03",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453edf6-b267-11f1-b4f4-0abd773ba497",
        "symbol": "AMDx",
        "name": "AMD xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "571.275",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453f017-b267-11f1-b4f4-0abd773ba497",
        "symbol": "AMZNx",
        "name": "Amazon.com xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "255.205",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453ef2b-b267-11f1-b4f4-0abd773ba497",
        "symbol": "AVGOx",
        "name": "Broadcom xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "361.13",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453ef67-b267-11f1-b4f4-0abd773ba497",
        "symbol": "COINx",
        "name": "Coinbase xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "196.715",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "322fe763-c069-4d11-be35-b9563f6e22c4",
        "symbol": "CORZx",
        "name": "Core Scientific xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "18.11",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453f225-b267-11f1-b4f4-0abd773ba497",
        "symbol": "CRMx",
        "name": "Salesforce xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "237.695",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      },
      {
        "deposit_enabled": true,
        "withdraw_enabled": true,
        "asset_id": "7453ee44-b267-11f1-b4f4-0abd773ba497",
        "symbol": "GOOGLx",
        "name": "Alphabet xStock",
        "asset_type": "stock",
        "status": "ACTIVE",
        "can_buy": true,
        "can_sell": true,
        "unavailable_reason": "",
        "reference_price": "351.2",
        "price_currency": "USD",
        "price_updated_at": "2026-09-21T01:30:00.000Z"
      }
    ],
    "total_items": 22,
    "total_pages": 3
  }
  ```
</ResponseExample>


## OpenAPI

````yaml /zh/stocks/stocks.yaml get /asset
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:
    get:
      tags:
        - Stocks
      summary: 列出资产
      description: 列出当前账户可见的资产。请求报价前检查可用能力。
      operationId: listStocksAssets
      parameters:
        - name: page_number
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 1
          description: 要查询的页码。
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          description: 每页返回的最大条目数。
        - name: symbol
          in: query
          required: false
          schema:
            type: string
            maxLength: 32
          description: 按资产代码筛选。
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetPage'
              examples:
                sandbox:
                  summary: Sandbox response
                  value:
                    data:
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453f146-b267-11f1-b4f4-0abd773ba497
                        symbol: AAPLx
                        name: Apple xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '334.85'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 896fa067-c017-40f4-9b72-4dde9732566f
                        symbol: ACNx
                        name: Accenture xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '193.3'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 54f913d6-eeb9-47c8-aa94-3d9fa1fd9304
                        symbol: ADBEx
                        name: Adobe xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '249.03'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453edf6-b267-11f1-b4f4-0abd773ba497
                        symbol: AMDx
                        name: AMD xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '571.275'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453f017-b267-11f1-b4f4-0abd773ba497
                        symbol: AMZNx
                        name: Amazon.com xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '255.205'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453ef2b-b267-11f1-b4f4-0abd773ba497
                        symbol: AVGOx
                        name: Broadcom xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '361.13'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453ef67-b267-11f1-b4f4-0abd773ba497
                        symbol: COINx
                        name: Coinbase xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '196.715'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 322fe763-c069-4d11-be35-b9563f6e22c4
                        symbol: CORZx
                        name: Core Scientific xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '18.11'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453f225-b267-11f1-b4f4-0abd773ba497
                        symbol: CRMx
                        name: Salesforce xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '237.695'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                      - deposit_enabled: true
                        withdraw_enabled: true
                        asset_id: 7453ee44-b267-11f1-b4f4-0abd773ba497
                        symbol: GOOGLx
                        name: Alphabet xStock
                        asset_type: stock
                        status: ACTIVE
                        can_buy: true
                        can_sell: true
                        unavailable_reason: ''
                        reference_price: '351.2'
                        price_currency: USD
                        price_updated_at: '2026-09-21T01:30:00.000Z'
                    total_items: 22
                    total_pages: 3
        '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' \
              --header "Content-Type: application/json" \
              --header "x-auth-token: Bearer ${SANDBOX_TOKEN}"
components:
  schemas:
    AssetPage:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
          description: 本页记录。空数组可能表示没有匹配记录或页码超出结果范围。
        total_pages:
          type: integer
          format: int64
          minimum: 0
          description: 按请求的每页条数计算的结果总页数。
          example: 3
        total_items:
          type: integer
          format: int64
          minimum: 0
          description: 所有页中符合筛选条件的记录总数。
          example: 22
      required:
        - data
        - total_pages
        - total_items
    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: 错误原因的可读说明。
    Asset:
      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
        name:
          type: string
          description: 资产名称。
          example: Apple xStock
        asset_type:
          type: string
          description: 资产类别，沿用资产目录的分类值
          example: stock
        status:
          type: string
          enum:
            - ACTIVE
            - INACTIVE
          description: 资产目录中的可用状态。请求报价前还应检查当前账户的买入和卖出能力。
          example: ACTIVE
        can_buy:
          type: boolean
          description: 当前资产和账户是否允许买入；提交时重新校验
          example: true
        can_sell:
          type: boolean
          description: 当前资产和账户是否允许卖出；提交时重新校验
          example: true
        unavailable_reason:
          type: string
          description: 无法交易的原因。空字符串表示未返回阻止交易的原因。
          example: ''
        reference_price:
          type: string
          pattern: ^-?[0-9]+(\.[0-9]+)?$
          nullable: true
          description: 每单位资产的参考价格，仅用于展示。交易和对账应使用报价及已结算订单；null 表示参考价格不可用。
          example: '334.85'
        price_currency:
          type: string
          enum:
            - USD
          description: 参考价格的计价币种。
          example: USD
        price_updated_at:
          type: string
          format: date-time
          nullable: true
          description: 该参考行情采样时间
          example: '2026-09-21T01:30:00.000Z'
        deposit_enabled:
          type: boolean
          description: 当前资产及账户是否已启用充值能力，与买入能力分别判断。
          example: true
        withdraw_enabled:
          type: boolean
          description: 当前资产及账户是否已启用提现能力，与卖出能力分别判断。
          example: true
      required:
        - asset_id
        - symbol
        - name
        - asset_type
        - status
        - can_buy
        - can_sell
        - unavailable_reason
        - reference_price
        - price_currency
        - price_updated_at
        - deposit_enabled
        - withdraw_enabled
  securitySchemes:
    AuthToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: 由 UQPAY 提供的登录 API Token。

````