Skip to main content
GET
Get asset details
Batch Support Available: This endpoint supports batch queries via POST method for fetching multiple assets in a single request. Jump to Batch Query section

Overview

The Asset Details endpoint provides comprehensive asset-level data including metadata, market statistics, price changes, and detailed token information for each contract across all supported blockchains. Unlike the Token Details endpoint which focuses on a single token contract, this endpoint aggregates data at the asset level and returns detailed information for all associated tokens.

GET Method - Single Asset Query

Retrieve detailed asset information for a single asset, identified either by asset ID or by a token address and blockchain.

Query Parameters

  • id (optional) — The asset ID (integer). Use this to query by asset ID directly.
  • address (required if no id) — Token contract address. Must be used together with blockchain.
  • blockchain (required if using address) — The blockchain identifier (e.g., evm:1, solana, ethereum)
  • tokensLimit (optional) — Maximum number of tokens to return detailed data for. Default: 10, Max: 50.

Step-by-Step Tutorial and Video Walkthrough

  • Check out the guide: Here

Usage Examples

Query by Asset ID:
Query by Address and Blockchain:
With Custom Token Limit:

Response Format

Response Fields

Asset Object

Tokens Array

Each token object in the tokens array contains the same fields as the Token Details endpoint, providing comprehensive on-chain data for each token contract associated with the asset.

Error Responses

Notes

  • When querying by address and blockchain, the endpoint finds the asset associated with that token and returns data for the entire asset including all its tokens.
  • The tokensLimit parameter controls how many tokens get enriched with detailed trading data. Set a lower limit for faster responses.
  • Token details include real-time trading statistics, holder information, and security flags across all supported DEXes.

POST Method - Batch Query

Retrieve asset details for multiple assets in a single request for improved efficiency.

Request Body

Body Parameters

The request body is an array of objects, where each object contains:
  • id (optional) — The asset ID. Either id OR address + blockchain must be provided.
  • address (optional) — Token contract address. Must be used with blockchain.
  • blockchain (optional) — The blockchain identifier. Required when using address.
  • tokensLimit (optional) — Maximum number of tokens per asset. Default: 10, Max: 50.

Usage Examples

Response Format

Use Cases

  • GET: Single asset monitoring, real-time price checks, detailed asset analysis
  • POST: Portfolio analysis, bulk asset research, multi-asset dashboard data

Query Parameters

id
number | null

Asset ID

address
string

Token contract address

chainId
string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

tokensLimit
number
required

Maximum number of tokens to return (1-50, default: 10)

Required range: 1 <= x <= 50

Response

200 - application/json

Asset details response

data
object
required
hostname
string