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

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)

  - `items.ledgerId` (string, required)

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

  - `items.name` (string, required)

  - `items.decimals` (integer)

  - `items.symbol` (string)

  - `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", "Cardano", "Ethereum", "Hedera", "Solana", "Stellar", "Substrate", "Tezos", "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

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