> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get curated Aleo token prices for the given network

> Returns a stable list of `(address, isNative, tokenId, price)` rows for every curated Aleo token on the requested network — independent of the caller's balance. Used by the widget to display fiat values on the Shielded balance tab, which is built client-side from records and never goes through the multichain `/accountBalances` endpoint. Tokens whose CoinGecko id has no cached price are returned with `price: null`.




## OpenAPI

````yaml https://app.dynamic.xyz/api-docs/public-api.yaml get /sdk/{environmentId}/chains/aleo/prices
openapi: 3.0.1
info:
  title: Dashboard API
  description: Dashboard API documentation
  version: 1.0.0
servers:
  - url: https://app.dynamicauth.com/api/v0
  - url: https://app.dynamic.xyz/api/v0
  - url: http://localhost:3333/api/v0
security: []
tags:
  - name: Analytics
    description: Query usage analytics and event counts for your environment.
  - name: SDK
    description: SDK-facing endpoints consumed by embedded Dynamic clients.
  - name: Organizations
    description: >-
      Manage organizations — the top-level container for all environments and
      projects.
  - name: Projects
    description: Manage projects that group related environments under an organization.
  - name: Environments
    description: >-
      Manage environments (live and sandbox) where your authentication
      configuration lives.
  - name: Users
    description: List, search, and manage authenticated users within an environment.
  - name: Invites
    description: >-
      Manage invitation links that grant specific external users access to your
      environment.
  - name: Tokens
    description: >-
      Create and manage API tokens used to authenticate requests to the Dynamic
      API.
  - name: Origins
    description: >-
      Configure allowed origins (CORS) for SDK and API access to your
      environment.
  - name: Allowlists
    description: >-
      Manage allowlists to control which wallet addresses or email addresses can
      access your environment.
  - name: Wallets
    description: View and manage wallets linked to users in your environment.
  - name: Members
    description: Manage team members and their roles within an organization.
  - name: Sessions
    description: View and revoke active user sessions within an environment.
  - name: Settings
    description: Read and update environment-level configuration settings.
  - name: Exchanges
    description: >-
      Configure exchange integrations (Coinbase, Binance, etc.) for fiat on-ramp
      within your environment.
  - name: Providers
    description: >-
      List, enable, disable, and configure authentication providers (OAuth,
      email, wallet, SMS, etc.) for your environment.
  - name: Captcha
    description: >-
      Configure captcha verification (provider, site key, secret key) for your
      environment.
  - name: Gates
    description: >-
      Define access gates that restrict environment entry to users who meet
      specific criteria.
  - name: Chains
    description: >-
      Manage the blockchain networks available for wallet connection in your
      environment.
  - name: Exports
    description: Export user and wallet data from your environment as downloadable files.
  - name: Events
    description: Browse the event log of actions performed within your environment.
  - name: Webhooks
    description: >-
      Create and manage webhooks to receive real-time events (user.created,
      wallet.linked, etc.) at your endpoint.
  - name: Custom Fields
    description: >-
      Define and manage custom metadata fields collected from users at sign-up
      or login.
  - name: MfaSettings
    description: >-
      Configure multi-factor authentication (MFA) policies for your
      organization.
  - name: Mfa
    description: Manage MFA enrollment and verification for individual users.
  - name: CustomHostnames
    description: >-
      Configure custom hostnames for white-labeling the Dynamic authentication
      experience.
  - name: TestAccount
    description: >-
      Manage test accounts used for automated testing and QA within an
      environment.
  - name: NameServices
    description: >-
      Configure name service integrations (ENS, Unstoppable Domains, etc.) for
      human-readable wallet addresses.
  - name: GlobalWallets
    description: >-
      Manage global wallets shared across multiple environments in an
      organization.
  - name: GlobalWalletConnections
    description: Configure which environments can access and use global wallets.
  - name: GlobalWalletAccessControl
    description: Control which users and roles can access and operate global wallets.
  - name: UserApiTokens
    description: >-
      Create and manage user-scoped API tokens for programmatic access on behalf
      of a user.
  - name: Waas
    description: Wallet-as-a-Service endpoints for creating and managing embedded wallets.
  - name: WalletConnect
    description: Configure WalletConnect integration settings for your environment.
  - name: Checkout
    description: >-
      Accept crypto payments and deposits from any wallet. Settle in any token
      you choose.
  - name: Flow
    description: >-
      Accept crypto payments, deposits, and withdrawals. Amount and destination
      are fixed server-side at create; the post-create lifecycle is driven with
      a capability session token.
  - name: Custom Networks
    description: >-
      Add and manage custom EVM-compatible networks beyond the built-in chain
      list.
  - name: Chainalysis
    description: >-
      Configure Chainalysis integration for blockchain address screening and
      risk assessment.
  - name: Visits
    description: Track and query user visit activity within your environment.
  - name: ExternalJwt
    description: >-
      Configure external JWT providers so existing auth tokens can be used with
      Dynamic.
  - name: SDK Views
    description: >-
      Manage SDK view configurations that customize the appearance of Dynamic
      modals and flows.
  - name: DeeplinkUrls
    description: Configure deep link URLs for mobile app integration with the Dynamic SDK.
  - name: OrganizationSettings
    description: >-
      Read and update organization-level settings such as approval workflow
      configuration.
  - name: AdminActions
    description: >-
      Manage admin action requests that require approval from another
      administrator.
  - name: ClientGrant
    description: |
      OAuth 2.0 Device Authorization Grant flow (RFC 8628) used by first-party
      Dynamic clients (CLI, MCP server, demo apps, IDE plugins) to obtain a
      revocable, 30-day client JWT without ever seeing the user's dashboard
      session token.
  - name: AuthorizedClients
    description: |
      Manage first-party clients (CLI / MCP / demo / IDE plugins) authorized
      to act as a dashboard user. Surfaced under Profile → Authorized Clients.
paths:
  /sdk/{environmentId}/chains/aleo/prices:
    get:
      tags:
        - SDK
      summary: Get curated Aleo token prices for the given network
      description: >
        Returns a stable list of `(address, isNative, tokenId, price)` rows for
        every curated Aleo token on the requested network — independent of the
        caller's balance. Used by the widget to display fiat values on the
        Shielded balance tab, which is built client-side from records and never
        goes through the multichain `/accountBalances` endpoint. Tokens whose
        CoinGecko id has no cached price are returned with `price: null`.
      operationId: getAleoCuratedPrices
      parameters:
        - $ref: '#/components/parameters/environmentId'
        - in: query
          name: network
          required: true
          schema:
            type: string
            enum:
              - testnet
              - mainnet
          description: Aleo network whose curated price list to return.
      responses:
        '200':
          description: Curated price list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AleoCuratedPricesResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '502':
          $ref: '#/components/responses/BadGateway'
      security:
        - bearerAuth: []
components:
  parameters:
    environmentId:
      in: path
      name: environmentId
      required: true
      description: ID of the environment
      schema:
        $ref: '#/components/schemas/uuid'
  schemas:
    AleoCuratedPricesResponse:
      description: |
        Response wrapper for `GET /chains/aleo/prices`. Always present even
        when the requested network has no curated tokens — `result.prices`
        will simply be an empty array.
      type: object
      required:
        - result
      properties:
        result:
          type: object
          required:
            - prices
          properties:
            prices:
              description: |
                Curated token list for the requested network. Every curated
                entry is returned regardless of whether the caller holds the
                token; the widget renders the full surface and joins by
                `(address, isNative)`.
              type: array
              items:
                $ref: '#/components/schemas/AleoCuratedTokenPrice'
    uuid:
      type: string
      pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      minLength: 36
      maxLength: 36
      example: 95b11417-f18f-457f-8804-68e361f9164f
    AleoCuratedTokenPrice:
      description: |
        Single entry in the Aleo curated price list. The shape mirrors the
        multichain balance entry shape (`address`, `isNative`) so the widget
        can join the prices response against its unshielded balance feed on
        `(address, isNative)` without any translation.
      type: object
      required:
        - address
        - isNative
        - logoURI
        - symbol
        - tokenId
        - price
      properties:
        address:
          description: |
            Wallet-facing token address. Native ALEO uses the `'0x0'` sentinel
            (matches `ALEO_NATIVE_ASSET.contractAddress` and the multichain
            balance feed); every other entry uses the on-chain program id
            (e.g. `usdcx_stablecoin.aleo`, `hyp_warp_token_eth.aleo`).
          type: string
        isNative:
          description: True for the native ALEO entry, false for every other token.
          type: boolean
        logoURI:
          description: |
            Brand logo for the token. Surfaced so the widget's Shielded
            balance tab can render the same icon the unshielded multichain
            feed renders for the same `(address, isNative)` key, instead of
            falling through to the generic `?` placeholder.
          type: string
        symbol:
          description: Display symbol (e.g. `ALEO`, `USDCx`, `wETH`).
          type: string
        tokenId:
          description: |
            CoinGecko id used to resolve the fiat price. Echoed back so
            consumers can confirm which pricing source produced the value.
          type: string
        price:
          description: |
            USD price per whole token unit, or `null` when the pricing source
            has no current price (token is unranked, cache miss, etc.) and
            no fallback is pinned in the registry. Clients should render an
            empty cell rather than treating `null` as `0`.
          type: number
          nullable: true
    BadRequest:
      type: object
      properties:
        error:
          description: Human-readable error message
          type: string
    Unauthorized:
      type: object
      properties:
        error:
          description: Human-readable error message describing the authentication failure
          type: string
          example: No jwt provided!
    InternalServerError:
      type: object
      properties:
        error:
          description: Human-readable error message
          type: string
          example: Internal Server Error
    BadGateway:
      type: object
      properties:
        error:
          description: Human-readable error message
          type: string
          example: Error from Snowflake service
      required:
        - error
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BadRequest'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Unauthorized'
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InternalServerError'
    BadGateway:
      description: Bad Gateway
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BadGateway'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````