Assets

The asset catalog lists the assets Covalent knows, by a chain-qualified ID, with each asset's state under your company's asset policy in the API key's environment. An asset with enabled: false is one that POST /api/v2/transfers refuses there. The policy is set on the dashboard's Assets page, and can change at any time: answers are never cached.

Endpoint

Method	Endpoint	Scope
GET	/api/v2/assets	transfers:read

Request

curl "$COVALENT_URL/api/v2/assets?q=eth&network=ethereum&limit=50" \
  -H "x-api-key: $COVALENT_API_KEY"

Parameter	Description
q	Words that must all appear in the asset's ID, name, network, aliases or CoinGecko IDs, any case. At most 200 characters.
network	One network's assets.
assetId	One asset, by its ID.
limit	Assets per page, 1 to 200, default 50.
offset	How many matching assets to skip, default 0.

This list pages by offset, not by cursor. A disabled asset is listed, not left out, so the paging and meta.total are the catalog's.

Response

Each asset:

{
  "id": "eip155:1/slip44:60",
  "name": "Ethereum",
  "network": "ethereum",
  "chainId": "eip155:1",
  "assetReference": "slip44:60",
  "decimals": 18,
  "sourceNetwork": "ethereum",
  "aliases": ["ETH", "ETH-ETH"],
  "coinGeckoIds": ["ethereum"],
  "enabled": true
}

Field	Description
id	The chain-qualified asset ID: never a ticker alone.
aliases	The asset's codes, shortest first.
enabled	Whether new outgoing transfers of the asset are accepted in the key's environment.

meta says where the catalog comes from and which page this is:

Field	Description
storage	local_snapshot: the catalog is a snapshot shipped with Covalent.
fetchedAt	When the snapshot was taken.
sourceSha256	The SHA-256 of the snapshot's source.
sourceEntryCount, assetCount, networkCount	How many source entries, assets and networks the catalog has.
coverage	reference_only: the catalog is reference data.
total	How many assets match the filters.
limit, offset	The page asked for.

A query it cannot read, such as limit=0, is 400 INVALID_QUERY with details.issues.