> ## Documentation Index
> Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List assets

> List the crypto assets available for purchase, including DeFi tokens

<Info>
  Some Platform API capabilities must be enabled on your account by MoonPay
  before you can call them. If this endpoint returns an unexpected `404`, see
  [Capability
  enablement](/api-reference/platform/documentation/using-the-api#capability-enablement).
</Info>


## OpenAPI

````yaml GET /platform/v1/assets
openapi: 3.1.0
info:
  title: MoonPay
  version: 1.0.0
servers:
  - url: https://api.moonpay.com
    description: Production Environment
    variables: {}
  - url: https://api.moonpay.dev
    description: Sandbox Environment
    variables: {}
security: []
tags:
  - name: Assets
  - name: Quote
  - name: Customer
  - name: Identity
  - name: Transactions
paths:
  /platform/v1/assets:
    get:
      tags:
        - Assets
      summary: List assets
      description: >-
        Returns a paginated list of crypto assets (CeFi and DeFi) available for
        purchase through MoonPay. Filter by `source` and `code`. Authenticate
        with a scoped access token (`Authorization: Bearer <jwt>`) or
        server-side with the partner's secret API key (`X-Api-Key`).
      operationId: AssetController.listAssets
      parameters:
        - $ref: '#/components/parameters/AssetPaginationQueryParams.source'
        - $ref: '#/components/parameters/AssetPaginationQueryParams.code'
        - $ref: '#/components/parameters/MoonPay.Core.PaginationQueryParams.cursor'
        - $ref: '#/components/parameters/MoonPay.Core.PaginationQueryParams.limit'
      responses:
        '200':
          description: The request has succeeded.
          headers:
            X-Request-Id:
              required: true
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - pageInfo
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PlatformAsset'
                  pageInfo:
                    $ref: '#/components/schemas/MoonPay.Core.PaginationInfo'
                unevaluatedProperties:
                  not: {}
      security:
        - AccessTokenAuth: []
        - SecretApiKeyInHeaderAuth: []
components:
  parameters:
    AssetPaginationQueryParams.source:
      name: source
      in: query
      required: false
      description: |-
        Filter by asset source.
        - `cefi`: only centralised assets listed by MoonPay.
        - `defi`: only DeFi tokens.
        - omitted: both are returned.
      schema:
        type: string
        enum:
          - cefi
          - defi
      explode: false
    AssetPaginationQueryParams.code:
      name: code
      in: query
      required: false
      description: Filter by exact (case-insensitive) asset code.
      schema:
        type: string
      explode: false
    MoonPay.Core.PaginationQueryParams.cursor:
      name: cursor
      in: query
      required: false
      description: >-
        Cursor for pagination. Use the `nextCursor` value from the previous
        response.
      schema:
        type: string
      explode: false
    MoonPay.Core.PaginationQueryParams.limit:
      name: limit
      in: query
      required: false
      description: Number of items to return per page.
      schema:
        type: integer
        format: int32
        minimum: 1
        maximum: 50
        default: 50
      explode: false
  schemas:
    PlatformAsset:
      type: object
      required:
        - caip19
        - code
        - name
        - network
        - source
        - contractAddress
        - decimals
        - precision
        - status
      properties:
        caip19:
          type: string
          description: >-
            The CAIP-19 asset identifier (encodes chain and contract). Use this
            value when creating quotes for DeFi tokens.
          examples:
            - >-
              solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        code:
          type: string
          description: The asset code. Use this value when creating quotes for CeFi assets.
          examples:
            - USDC
            - BTC
        name:
          type: string
          description: The human-readable name of the asset.
          examples:
            - Bitcoin
        network:
          type: string
          description: The blockchain network code this asset belongs to.
          examples:
            - solana
            - ethereum
        source:
          type: string
          enum:
            - cefi
            - defi
          description: >-
            Whether this is a centralised asset listed by MoonPay (`cefi`) or a
            DeFi token (`defi`). Quote CeFi assets by `code` and DeFi tokens by
            `caip19`.
          examples:
            - cefi
        contractAddress:
          anyOf:
            - type: string
            - type: 'null'
          description: The on-chain contract address. Null for native gas tokens.
          examples:
            - EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        decimals:
          anyOf:
            - type: integer
              format: int32
            - type: 'null'
          description: The number of decimal places used on-chain, or null if unknown.
          examples:
            - 6
        precision:
          anyOf:
            - type: integer
              format: int32
            - type: 'null'
          description: >-
            The maximum decimal places MoonPay supports when trading this asset.
            `null` when MoonPay doesn't list a trading precision for it
            (typically DeFi tokens).
          examples:
            - 2
        status:
          $ref: '#/components/schemas/AssetStatus'
      unevaluatedProperties:
        not: {}
      description: A crypto asset available for purchase through MoonPay.
      examples:
        - caip19: >-
            solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          code: USDC
          name: USD Coin (Solana)
          network: solana
          source: cefi
          contractAddress: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          decimals: 6
          precision: 2
          status:
            suspended: false
            disabled: false
    MoonPay.Core.PaginationInfo:
      type: object
      required:
        - nextCursor
      properties:
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The cursor to use as the starting point for the next page of
            results.
          default: null
      unevaluatedProperties:
        not: {}
    AssetStatus:
      type: object
      required:
        - suspended
        - disabled
      properties:
        suspended:
          type: boolean
          description: Temporarily unavailable for trading.
        disabled:
          type: boolean
          description: Disabled for trading.
      unevaluatedProperties:
        not: {}
      description: Current status flags for an asset.
      examples:
        - suspended: false
          disabled: false
  securitySchemes:
    AccessTokenAuth:
      type: http
      scheme: bearer
      description: |-
        Bearer authentication header using an access token.

        Example: `Authorization: Bearer <accessToken>`
    SecretApiKeyInHeaderAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: |-
        Secret key authentication via the `X-Api-Key` header.

        Example: `X-Api-Key: <secretKey>`

````