---
title: "GET /v1/assets"
method: GET
path: "/v1/assets"
tags: ["Assets"]
deprecated: true
---

# GET /v1/assets

`GET /v1/assets`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/assets`
- Auth: API key in header `x-api-key`

> **Deprecated.**

## Query parameters

- `page` integer: Page number
- `pageSize` integer: Items per page (max 100)
- `id` string: Filter by asset ID
- `symbol` string: Filter by asset symbol
- `name` string: Filter by asset name
- `search` string: Search asset ID, symbol, or name
- `tokenSearch` string: Search token symbol or address
- `tokenIsSpam` boolean: Filter by token spam status
- `hasExchangeToken` boolean: Filter assets by whether they have exchange tokens
- `hasStablecoinPeg` boolean: Filter by stablecoin peg presence
- `stablecoinPeggedFiatCurrency` string: Filter by stablecoin pegged fiat currency
- `includeTokens` boolean: Include tokens for the returned asset page

## Response `200`

- PaginatedAssetsResponseDto
  - `data` object[], required
    - `id` string, required: Asset ID
    - `symbol` string, required: Asset symbol
    - `name` string, required: Asset name
    - `logoUrl` string, nullable, required: Asset logo URL
    - `coingeckoId` string, nullable, required: CoinGecko coin ID
    - `stablecoinPeggedFiatCurrency` string, nullable, required: Pegged fiat currency for stablecoins
    - `fairValueScope` 'IN_SCOPE' | 'OUT_OF_SCOPE' | 'NEEDS_REVIEW', required: ASC 350-60 fair-value remeasurement scope for this asset
    - `isFiat` boolean, required: Whether this asset is fiat currency
    - `tokensCount` integer, required: Number of tokens linked to asset
    - `createdAt` string, date-time, required: Creation timestamp (ISO 8601)
    - `updatedAt` string, date-time, required: Last update timestamp (ISO 8601)
    - `tokens` object[]: Tokens linked to this asset when includeTokens=true
      - `chainId` string, required: Chain ID
      - `address` string, required: Token contract or mint address
      - `name` string, required: Token name
      - `symbol` string, required: Token symbol
      - `decimals` integer, required: Token decimals
      - `logoUrl` string, nullable, required: Token logo URL
      - `type` 'ERC20' | 'FIAT' | 'NATIVE' | 'REBASE_LST' | 'INTEREST_BEARING' | 'VALUE_ACCRUING' | 'LP_SHARE' | 'DEBT' | 'REFLECT' | 'VOTE_ESCROWED' | 'NFT', required: Token type
      - `description` string, nullable, required: Token description
      - `metadata` object, nullable, required: Token metadata
      - `nftContractAddress` string, nullable, required: NFT contract address
      - `coingeckoId` string, nullable, required: CoinGecko coin ID
      - `assetId` string, required: Asset ID
      - `isSpam` boolean, required: Whether the token is marked as spam
      - `chain` object, required: Token chain
        - `chainId` string, required: Public chain ID
        - `name` string, required: Chain name
        - `type` 'BLOCKCHAIN' | 'EXCHANGE' | 'BANK', required: Chain type
      - `createdAt` string, date-time, required: Creation timestamp (ISO 8601)
      - `updatedAt` string, date-time, required: Last update timestamp (ISO 8601)
  - `pagination` object, required
    - `page` integer, required: Current page number
    - `pageSize` integer, required: Items per page
    - `totalCount` integer, required: Total number of items
    - `totalPages` integer, required: Total number of pages

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)