curl --request GET \
--url https://api.zerion.io/v1/fungibles/ \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.zerion.io/v1/fungibles/"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.zerion.io/v1/fungibles/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zerion.io/v1/fungibles/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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",
"flags": {
"verified": true
},
"external_links": [
{
"url": "https://www.indexcoop.com",
"type": "website",
"name": "Website"
}
],
"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": {
"price": 106.87952669793131,
"total_supply": 29905.762448515918,
"circulating_supply": 29905.762448515918,
"fully_diluted_valuation": 3196313.736038149,
"market_cap": 3196313.736038149,
"changes": {
"percent_1d": -0.7379066649086338,
"percent_30d": -2.499465618806962,
"percent_90d": 11.316340269371775,
"percent_365d": null
},
"trading_volumes": {
"volume_1d": 40096375.69294812
}
},
"asset_class": "commodity",
"description": "The BED index is meant to track crypto's top 3 investab.",
"icon": {
"url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
}
},
"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"
}
}
}
}
]
}{
"errors": [
{
"title": "Parameter is malformed",
"detail": "Some validation errors will be described here"
}
]
}{
"errors": [
{
"title": "Unauthorized Error",
"detail": "The API key is invalid, please, make sure that you are using a valid key"
}
]
}{
"errors": [
{
"title": "Too many requests",
"detail": "Your request had been throttled"
}
]
}Get list of fungible assets
Search and filter the token catalog Zerion supports, with prices, market data and per-chain implementations.
curl --request GET \
--url https://api.zerion.io/v1/fungibles/ \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.zerion.io/v1/fungibles/"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.zerion.io/v1/fungibles/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zerion.io/v1/fungibles/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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",
"flags": {
"verified": true
},
"external_links": [
{
"url": "https://www.indexcoop.com",
"type": "website",
"name": "Website"
}
],
"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": {
"price": 106.87952669793131,
"total_supply": 29905.762448515918,
"circulating_supply": 29905.762448515918,
"fully_diluted_valuation": 3196313.736038149,
"market_cap": 3196313.736038149,
"changes": {
"percent_1d": -0.7379066649086338,
"percent_30d": -2.499465618806962,
"percent_90d": 11.316340269371775,
"percent_365d": null
},
"trading_volumes": {
"volume_1d": 40096375.69294812
}
},
"asset_class": "commodity",
"description": "The BED index is meant to track crypto's top 3 investab.",
"icon": {
"url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
}
},
"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"
}
}
}
}
]
}{
"errors": [
{
"title": "Parameter is malformed",
"detail": "Some validation errors will be described here"
}
]
}{
"errors": [
{
"title": "Unauthorized Error",
"detail": "The API key is invalid, please, make sure that you are using a valid key"
}
]
}{
"errors": [
{
"title": "Too many requests",
"detail": "Your request had been throttled"
}
]
}Authorizations
Query Parameters
Denominated currency value of returned prices
eth, btc, usd, eur, krw, rub, gbp, aud, cad, inr, jpy, nzd, try, zar, cny, chf Pagination parameters
Show child attributes
Show child attributes
Full-text search query, 1 to 66 characters.
1 - 66"Index"
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.
"polygon"
Keep only tokens deployed at this address. Different tokens can be deployed at the same address on different chains.
32 - 44"0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
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].
25Keep only these fungible IDs (comma-separated list, up to 25).
2544Keep 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.
1 - 7 elementsAsset classification for the fungible: tokenized real-world assets and stablecoins. A paid add-on, enabled per organization, returned on GET /v1/fungibles/, GET /v1/fungibles/{fungible_id}, GET /v1/fungibles/by-implementation, and on the fungible_info of GET /v1/wallets/{address}/positions/ and GET /v1/wallet-sets/{wallet_set_id}/positions/, only for organizations that have it. The fungible_info of a transaction (transfers, fees, approvals, refunds) never carries it. Omitted when the fungible is unclassified or its classification has been cleared. Absence does not mean the fungible is not an RWA. The value unknown is different from absence: it is a positive classification: the fungible is a likely RWA, with the specific class still pending.
commodity, tokenized_stock, tokenized_treasury, stablecoin, other_financial, other_non_financial, unknown 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.
true Sort order for the results.
-market_data.market_cap, market_data.market_cap, -market_data.price.last, market_data.price.last, -market_data.price.percent_change_1d, market_data.price.percent_change_1d, -market_data.price.percent_change_30d, market_data.price.percent_change_30d, -market_data.price.percent_change_90d, market_data.price.percent_change_90d, -market_data.price.percent_change_365d, market_data.price.percent_change_365d, -market_data.trading_volumes.volume_1d, market_data.trading_volumes.volume_1d Was this page helpful?