fungibles

Get list of fungible assets

Changed on

Returns 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

get/v1/fungibles/

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/fungibles/
  • Auth
    HTTP basic

Query parameters

currency'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'

Denominated currency value of returned prices

afterstring nullable

This field is used for result pagination. You SHOULD NOT use this parameter directly. To get the next page of the results you should use links.next field. Omit it to return the first page.

sizeinteger

Set maximum number of items per a page in the pagination.

Pagination parameters

filter[search_query]string
Example:Index

Full-text search query, 1 to 66 characters.

filter[implementation_chain_id]string
Example:polygon

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.

filter[implementation_address]string
Example:0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6

Keep only tokens deployed at this address. Different tokens can be deployed at the same address on different chains.

filter[fungible_implementations]string[]

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].

filter[fungible_ids]string[]

Keep only these fungible IDs (comma-separated list, up to 25).

filter[asset_class]AssetClass[]

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.

filter[has_asset_class]true

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'-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'

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 query request parameter filter[asset_class]

    • info

      added the new optional query request parameter filter[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