Get list of fungible assets
Changed onReturns a paginated list of the tokens Zerion supports, with search and filtering. When nothing matches the filters, the response is 200 with an empty list.
With filter[implementation_address] set, filter[search_query] is ignored. This may change.
A filter sent with an empty value returns 400 instead of being ignored. For example, filter[implementation_address]= is a malformed address, not a missing filter.
See also: Filtering and the 2000-character URL limit · Resource IDs
Request
- Base URLhttps://api.zerion.io
- URLhttps://api.zerion.io/v1/fungibles/
- AuthHTTP basic
Query parameters
Denominated currency value of returned prices
Pagination parameters
Full-text search query, 1 to 66 characters.
Keep only tokens on this chain. Defaults to all chains listed by GET /v1/chains/. Any listed chain is accepted, with no capability flag required. A chain that isn't listed (an unknown ID, a numeric or hexadecimal chain ID, an alias such as bsc instead of binance-smart-chain, or a retired or hidden chain) returns 400 rather than an empty result, with detail reading chain <id> does not support fungibles (for example chain 4663 does not support fungibles). A listed chain with no assets returns 200 with an empty list.
Keep only tokens deployed at this address. Different tokens can be deployed at the same address on different chains.
Keep only tokens with these implementations (comma-separated list of chain_id:address pairs, up to 25).
For example: base,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
Can't be combined with filter[implementation_chain_id] or filter[implementation_address].
Keep only these fungible IDs (comma-separated list, up to 25).
Keep only fungibles whose asset_class is one of the given values (comma-separated). Values are the public asset_class vocabulary; tokenized_treasury, other_financial and other_non_financial each cover every underlying class they group, and unknown selects fungibles identified as a likely RWA with the specific class still pending.
Part of the RWA classification add-on, enabled per organization: organizations without it get 403.
Mutually exclusive with filter[has_asset_class]. Cannot be combined with filter[fungible_ids], filter[fungible_implementations], filter[implementation_address], or an address given as filter[search_query]: those look fungibles up directly and would not apply the filter, so the request is refused with 400 instead. Combines with filter[implementation_chain_id], a text filter[search_query], sort, and pagination.
Keep only fungibles that carry an asset_class (any class, including unknown). The only accepted value is true: this filter has one meaning, and false is refused with 400 rather than read as "not an RWA" (absence of asset_class is not a negative signal, see the attribute's description).
Part of the RWA classification add-on, enabled per organization: organizations without it get 403.
Mutually exclusive with filter[asset_class], and subject to the same combination rules: refused with 400 alongside filter[fungible_ids], filter[fungible_implementations], filter[implementation_address], or an address given as filter[search_query]; combines with filter[implementation_chain_id], a text filter[search_query], sort, and pagination.
Sort order for the results.
Response
Response for requested list of fungibles
Example response
{
"links": {
"self": "https://api.zerion.io/v1/fungibles/",
"first": "https://api.zerion.io/v1/fungibles/",
"next": "https://api.zerion.io/v1/fungibles/",
"prev": "https://api.zerion.io/v1/fungibles/"
},
"data": [
{
"type": "fungibles",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6",
"attributes": {
"name": "Bankless BED Index",
"symbol": "BED",
"description": "The BED index is meant to track crypto's top 3 investab.",
"icon": {
"url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
},
"flags": {
"verified": true
},
"external_links": [
{
"type": "website",
"name": "Website",
"url": "https://www.indexcoop.com"
}
],
"implementations": [
{
"chain_id": "ethereum",
"address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6",
"decimals": 18,
"market_data": {
"trading_volumes": {
"volume_1d": 40096375.69294812
}
},
"deployment_date": "2020-09-09T11:11:13Z"
}
],
"market_data": {
"total_supply": 29905.762448515918,
"circulating_supply": 29905.762448515918,
"fully_diluted_valuation": 3196313.736038149,
"market_cap": 3196313.736038149,
"price": 106.87952669793131,
"changes": {
"percent_1d": -0.7379066649086338,
"percent_30d": -2.499465618806962,
"percent_90d": 11.316340269371775
},
"trading_volumes": {
"volume_1d": 40096375.69294812
}
}
},
"relationships": {
"chart_hour": {
"links": {
"related": "https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/hour"
},
"data": {
"type": "fungible_charts",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-hour"
}
},
"chart_day": {
"links": {
"related": "https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/day"
},
"data": {
"type": "fungible_charts",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-day"
}
},
"chart_week": {
"links": {
"related": "https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/week"
},
"data": {
"type": "fungible_charts",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-week"
}
},
"chart_month": {
"links": {
"related": "https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/month"
},
"data": {
"type": "fungible_charts",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-month"
}
},
"chart_year": {
"links": {
"related": "https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/year"
},
"data": {
"type": "fungible_charts",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-year"
}
},
"chart_max": {
"links": {
"related": "https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/max"
},
"data": {
"type": "fungible_charts",
"id": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-max"
}
}
}
}
]
}Changes
- info
added the new optional
queryrequest parameterfilter[asset_class] - info
added the new optional
queryrequest parameterfilter[has_asset_class] - info
added the optional property
///to the response with the status - info
added the optional property
////to the response with the status
- info