# List tickers

Endpoint: GET /v1/tickers
Security: httpAuth

## Security:

  - `httpAuth` (unknown)
    http bearer

## Query parameters:

  - `limit` (integer)
    The number of entities to return.

  - `startingAfter` (string)
    Entity id used to the determine beginning of query results.

  - `sortBy` (string)
    Property name used to sort the query results.

  - `sortOrder` (string)
    Sort order applied to the query results.

  - `ledgerId` (array)
    Return entities matching given ledger id.

  - `kind` (string)
    Return entities matching given kind.

  - `name` (array)
    Return entities with names that contains or equals to provided name.

  - `symbol` (array)
    Return entities with names that contains or equals to provided symbol.

  - `validationStatus` (string)
    Return entities matching the requested validation status

  - `lock` (array)
    Return tickers matching given lock status.

  - `issuer` (array)
    Return tickers issued by one of the given issuing addresses. Only set for assets whose ledger identifies them by an issuer, in which case it must be combined with assetCode to identify a single asset. Combine with ledgerId to keep the result unambiguous across ledgers.

  - `assetCode` (array)
    Return tickers whose asset code in the ledger matches one of the given codes. Only set for assets whose ledger identifies them by an issuer and a code, in which case it must be combined with issuer to identify a single asset. Combine with ledgerId to keep the result unambiguous across ledgers.

  - `assetReference` (array)
    Return tickers whose asset reference in the ledger matches one of the given references. Set for assets that a ledger identifies without an issuer, such as an issuance id, a contract address or a mint. Assets that need two values join them with a dash: <contractAddress>-<tokenId> for ERC721 and ERC1155, <tokenId>-<serialNumber> for a Hedera NFT. Combine with ledgerId to keep the result unambiguous across ledgers.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)
    Deletion target: Mar. 31st 2027

  - `items.ledgerId` (string, required)
    Deletion target: Mar. 31st 2027

  - `items.kind` (string, required)
    Enum: "Native", "Contract", "Token"

  - `items.name` (string, required)
    Deletion target: Mar. 31st 2027

  - `items.decimals` (integer)
    Deletion target: Mar. 31st 2027

  - `items.symbol` (string)
    Deletion target: Mar. 31st 2027

  - `items.ledgerDetails` (any, required)

  - `items.ledgerDetails.properties` (any, required)

  - `items.ledgerDetails.properties.type` (string, required)
    Enum: "Native"

  - `items.ledgerDetails.type` (string, required)
    Enum: "Algorand", "Bitcoin", "Canton", "Cardano", "Ethereum", "Hedera", "Solana", "Stellar", "Substrate", "Sui", "Tezos", "Tron", "XRPL"

  - `items.data` (object, required)

  - `items.data.id` (string, required)

  - `items.data.ledgerId` (string, required)

  - `items.data.name` (string, required)

  - `items.data.decimals` (integer)

  - `items.data.symbol` (string)

  - `items.data.lock` (string, required)
    Enum: "Unlocked", "Locked", "Archived"

  - `items.data.metadata` (object)

  - `items.data.metadata.description` (string)

  - `items.data.metadata.revision` (integer, required)

  - `items.data.metadata.createdAt` (string, required)

  - `items.data.metadata.createdBy` (object)

  - `items.data.metadata.createdBy.id` (string, required)

  - `items.data.metadata.createdBy.domainId` (string, required)

  - `items.data.metadata.lastModifiedAt` (string, required)

  - `items.data.metadata.customProperties` (object, required)

  - `items.signature` (string)

  - `count` (integer, required)

  - `currentStartingAfter` (string)

  - `nextStartingAfter` (string)

## Response 400:

  - `400` (unknown)
    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, Invalid value for: query parameter issuer, Invalid value for: query parameter assetCode, Invalid value for: query parameter assetReference

## Response 401:

  - `401` (unknown)
    One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)

## Response 401 fields (application/json):

  - `reason` (string, required)

  - `message` (string)

## Response 404:

  - `404` (unknown)
    Entity or Domain not found (EntityNotFoundError)

## Response 404 fields (application/json):

  - `reason` (string, required)

  - `message` (string)