---
title: "List tickers"
method: GET
path: "/v1/tickers"
tags: ["Tickers"]
---

# List tickers

`GET /v1/tickers`

## Query parameters

- `limit` integer
- `startingAfter` string, uuid
- `sortBy` 'id' | 'ledgerId' | 'kind' | 'name' | 'symbol'
- `sortOrder` 'ASC' | 'DESC'
- `ledgerId` string[]
- `kind` 'Native' | 'Contract' | 'Token'
- `name` string[]
- `symbol` string[]
- `validationStatus` 'Validated' | 'NonValidated'
- `lock` CoreLockStatus[]

## Response `200`

- CoreTickersCollection
  - `items` CoreApiTicker[], required
    - `id` string, uuid, required
    - `ledgerId` string, required
    - `kind` 'Native' | 'Contract' | 'Token', required
    - `name` string, required
    - `decimals` integer
    - `symbol` string
    - `ledgerDetails` union, required
      - CoreTickerLedgerDetailsAlgorand
        - `properties` CoreAlgorandTickerProperties, required
          - `type` 'Native', required
        - `type` 'Algorand', required
      - CoreTickerLedgerDetailsBitcoin
        - `properties` CoreBitcoinTickerProperties, required
          - `type` 'Native', required
        - `type` 'Bitcoin', required
      - CoreTickerLedgerDetailsCardano
        - `properties` CoreCardanoTickerProperties, required
          - `type` 'Native', required
        - `type` 'Cardano', required
      - CoreTickerLedgerDetailsEthereum
        - `properties` union, required
          - CoreEthereumTickerPropertiesERC1155
            - `address` string, required
            - `tokenId` string, required
            - `type` 'ERC1155', required
          - CoreEthereumTickerPropertiesERC20
            - `address` string, required
            - `type` 'ERC20', required
          - CoreEthereumTickerPropertiesERC721
            - `address` string, required
            - `tokenId` string, required — This field is a large integer and represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
            - `type` 'ERC721', required
          - CoreEthereumTickerPropertiesNative
            - `type` 'Native', required
        - `type` 'Ethereum', required
      - CoreTickerLedgerDetailsHedera
        - `properties` union, required
          - CoreHederaTickerPropertiesFungibleToken
            - `id` string, required — String consisting Hedera Token Id
            - `type` 'FungibleToken', required
          - CoreHederaTickerPropertiesNative
            - `type` 'Native', required
          - CoreHederaTickerPropertiesNonFungibleToken
            - `id` string, required — String consisting Hedera Token Id
            - `serialNumber` integer, required
            - `type` 'NonFungibleToken', required
        - `type` 'Hedera', required
      - CoreTickerLedgerDetailsSolana
        - `properties` union, required
          - CoreSolanaTickerPropertiesNative
            - `type` 'Native', required
          - CoreSolanaTickerPropertiesToken
            - `mint` string, required
            - `tokenType` 'SPL' | 'SPL2022', required
            - `type` 'Token', required
        - `type` 'Solana', required
      - CoreTickerLedgerDetailsStellar
        - `properties` union, required
          - CoreStellarTickerPropertiesNative
            - `type` 'Native', required
          - CoreStellarTickerPropertiesToken
            - `code` string, required
            - `issuer` string, required
            - `type` 'Token', required
        - `type` 'Stellar', required
      - CoreTickerLedgerDetailsSubstrate
        - `properties` CoreSubstrateTickerProperties, required
          - `type` 'Native', required
        - `type` 'Substrate', required
      - CoreTickerLedgerDetailsTezos
        - `properties` CoreTezosTickerProperties, required
          - `type` 'Native', required
        - `type` 'Tezos', required
      - CoreTickerLedgerDetailsTron
        - `properties` union, required
          - CoreTronTickerPropertiesNative
            - `type` 'Native', required
          - CoreTronTickerPropertiesTRC20
            - `contractAddress` string, required
            - `type` 'TRC20', required
        - `type` 'Tron', required
      - CoreTickerLedgerDetailsXRPL
        - `properties` union, required
          - CoreXrplTickerPropertiesFungibleToken
            - `currencyCode` string, required
            - `issuer` string, required
            - `type` 'FungibleToken', required
          - CoreXrplTickerPropertiesMultiPurposeToken
            - `issuanceId` string, required — XRPL MPToken Issuance ID (192-bit integer hex encoded)
            - `type` 'MultiPurposeToken', required
          - CoreXrplTickerPropertiesNative
            - `type` 'Native', required
        - `type` 'XRPL', required
    - `data` CoreApiTickerData, required
      - `id` string, uuid, required
      - `ledgerId` string, required
      - `kind` 'Native' | 'Contract' | 'Token', required
      - `name` string, required
      - `decimals` integer
      - `symbol` string
      - `ledgerDetails` union, required
        - CoreTickerLedgerDetailsAlgorand
          - `properties` CoreAlgorandTickerProperties, required
            - `type` 'Native', required
          - `type` 'Algorand', required
        - CoreTickerLedgerDetailsBitcoin
          - `properties` CoreBitcoinTickerProperties, required
            - `type` 'Native', required
          - `type` 'Bitcoin', required
        - CoreTickerLedgerDetailsCardano
          - `properties` CoreCardanoTickerProperties, required
            - `type` 'Native', required
          - `type` 'Cardano', required
        - CoreTickerLedgerDetailsEthereum
          - `properties` union, required
            - CoreEthereumTickerPropertiesERC1155
              - …
            - CoreEthereumTickerPropertiesERC20
              - …
            - CoreEthereumTickerPropertiesERC721
              - …
            - CoreEthereumTickerPropertiesNative
              - …
          - `type` 'Ethereum', required
        - CoreTickerLedgerDetailsHedera
          - `properties` union, required
            - CoreHederaTickerPropertiesFungibleToken
              - …
            - CoreHederaTickerPropertiesNative
              - …
            - CoreHederaTickerPropertiesNonFungibleToken
              - …
          - `type` 'Hedera', required
        - CoreTickerLedgerDetailsSolana
          - `properties` union, required
            - CoreSolanaTickerPropertiesNative
              - …
            - CoreSolanaTickerPropertiesToken
              - …
          - `type` 'Solana', required
        - CoreTickerLedgerDetailsStellar
          - `properties` union, required
            - CoreStellarTickerPropertiesNative
              - …
            - CoreStellarTickerPropertiesToken
              - …
          - `type` 'Stellar', required
        - CoreTickerLedgerDetailsSubstrate
          - `properties` CoreSubstrateTickerProperties, required
            - `type` 'Native', required
          - `type` 'Substrate', required
        - CoreTickerLedgerDetailsTezos
          - `properties` CoreTezosTickerProperties, required
            - `type` 'Native', required
          - `type` 'Tezos', required
        - CoreTickerLedgerDetailsTron
          - `properties` union, required
            - CoreTronTickerPropertiesNative
              - …
            - CoreTronTickerPropertiesTRC20
              - …
          - `type` 'Tron', required
        - CoreTickerLedgerDetailsXRPL
          - `properties` union, required
            - CoreXrplTickerPropertiesFungibleToken
              - …
            - CoreXrplTickerPropertiesMultiPurposeToken
              - …
            - CoreXrplTickerPropertiesNative
              - …
          - `type` 'XRPL', required
      - `lock` 'Unlocked' | 'Locked' | 'Archived', required
      - `metadata` CoreEntityMetadata
        - `description` string
        - `revision` integer, required
        - `createdAt` string, date-time, required
        - `createdBy` CoreUserReference
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `lastModifiedAt` string, date-time, required
        - `lastModifiedBy` CoreUserReference
          - `id` string, uuid, required
          - `domainId` string, uuid, required
        - `customProperties` CoreStringsMap, required
    - `signature` string, base64
  - `count` integer, required
  - `currentStartingAfter` string
  - `nextStartingAfter` string

## Other responses

- `400` — Invalid value for: query parameter limit, Invalid value for: query parameter startingAfter, Invalid value for: query parameter sortBy, Invalid value for: query parameter sortOrder, Invalid value for: query parameter ledgerId, Invalid value for: query parameter kind, Invalid value for: query parameter name, Invalid value for: query parameter symbol, Invalid value for: query parameter validationStatus, Invalid value for: query parameter lock
- `401` — One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)
- `404` — Entity or Domain not found (EntityNotFoundError)

---

[API](https://skmtc.net/ripple/apis/ripple-custody-api.md) · [All operations](https://skmtc.net/ripple/apis/ripple-custody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripple-custody-api/revisions/0b55c0ddf07a/schema)