> ## Documentation Index > Fetch the complete documentation index at: https://developers.zerion.io/llms.txt > Use this file to discover all available pages before exploring further. # Get list of fungible assets > Search and filter the token catalog Zerion supports, with prices, market data and per-chain implementations. ## OpenAPI ````yaml /openapi-v1.yaml get /v1/fungibles/ openapi: 3.0.3 info: version: 1.0.0 title: REST API description: REST-like API provides access to rich Zerion ecosystem. contact: name: Zerion API url: https://developers.zerion.io/ email: api@zerion.io servers: - description: Production API url: https://api.zerion.io security: - APIKeyBasicAuth: [] tags: - name: wallets description: >- Operations related to wallets, such as portfolio charts, positions, and transactions. - name: wallet sets description: >- Operations on a wallet set, returning aggregated portfolio data across at most one EVM address and one Solana address queried together. - name: fungibles description: >- Operations related to fungible assets, such as list them all, search or get by ID. - name: chains description: Operations related to chains, such as list all chains. - name: swap description: Operations related to swapping and bridging assets. - name: gas description: Operations related to gas. - name: nfts description: >- Operations related to non fungible assets, such list them, search or get by ID. - name: dapps description: >- Operations related to decentralized applications, such as list them all, search or get by ID. - name: subscriptions to transactions description: Operations related to subscriptions to transactions. paths: /v1/fungibles/: get: tags: - fungibles summary: Get list of fungible assets description: > 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](https://developers.zerion.io/pagination-and-filtering#filtering) ยท [Resource IDs](https://developers.zerion.io/endpoints-and-schema#resource-ids) operationId: listFungibles parameters: - $ref: '#/components/parameters/Currency' - $ref: '#/components/parameters/Page' - name: filter[search_query] in: query required: false description: Full-text search query, 1 to 66 characters. schema: type: string example: Index minLength: 1 maxLength: 66 - name: filter[implementation_chain_id] in: query required: false description: >- 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 does not support fungibles` (for example `chain 4663 does not support fungibles`). A listed chain with no assets returns `200` with an empty list. schema: type: string example: polygon - name: filter[implementation_address] in: query required: false description: >- Keep only tokens deployed at this address. Different tokens can be deployed at the same address on different chains. schema: type: string minLength: 32 maxLength: 44 example: '0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6' - name: filter[fungible_implementations] in: query required: false style: form explode: false description: > 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]`. schema: type: array maxItems: 25 items: type: string - name: filter[fungible_ids] in: query required: false description: Keep only these fungible IDs (comma-separated list, up to 25). style: form explode: false schema: type: array maxItems: 25 items: type: string maxLength: 44 - $ref: '#/components/parameters/FilterAssetClass' - $ref: '#/components/parameters/FilterHasAssetClass' - name: sort in: query required: false description: Sort order for the results. schema: type: string enum: - '-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 responses: '200': $ref: '#/components/responses/FungiblesListResponse' '400': $ref: '#/components/responses/MalformedParameters' '401': $ref: '#/components/responses/UnauthenticatedError' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: Currency: name: currency in: query required: false description: Denominated currency value of returned prices schema: type: string default: usd enum: - eth - btc - usd - eur - krw - rub - gbp - aud - cad - inr - jpy - nzd - try - zar - cny - chf Page: name: page in: query required: false description: Pagination parameters style: deepObject explode: true schema: type: object properties: after: type: string nullable: true minLength: 1 maxLength: 64 description: > 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. size: type: integer format: uint8 description: Set maximum number of items per a page in the pagination. default: 100 minimum: 1 maximum: 100 FilterAssetClass: name: filter[asset_class] in: query required: false style: form explode: false description: > 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. schema: type: array minItems: 1 maxItems: 7 items: $ref: '#/components/schemas/AssetClass' example: - tokenized_stock - tokenized_treasury FilterHasAssetClass: name: filter[has_asset_class] in: query required: false description: > 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. schema: type: boolean enum: - true example: true responses: FungiblesListResponse: description: Response for requested list of fungibles content: application/json: schema: $ref: '#/components/schemas/ResponseMany-2' MalformedParameters: description: Parameters are malformed content: application/json: schema: type: object properties: errors: type: array items: type: object properties: title: type: string description: Error short title example: Parameter is malformed detail: type: string description: Long description of the error example: Some validation errors will be described here UnauthenticatedError: description: Unathenticated request content: application/json: schema: type: object properties: errors: type: array items: type: object properties: title: type: string description: Error short title example: Unauthorized Error detail: type: string description: Long description of the error example: >- The API key is invalid, please, make sure that you are using a valid key TooManyRequests: description: Too many requests error content: application/json: schema: type: object properties: errors: type: array items: type: object properties: title: type: string description: Error short title example: Too many requests detail: type: string description: Long description of the error example: Your request had been throttled schemas: AssetClass: type: string description: >- Asset 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. enum: - commodity - tokenized_stock - tokenized_treasury - stablecoin - other_financial - other_non_financial - unknown x-enum-descriptions: commodity: Tokenized commodities (e.g. gold). tokenized_stock: Tokenized equities, including tokenized ETFs. tokenized_treasury: Tokenized treasury and government-debt products. stablecoin: Fiat-pegged stablecoins. other_financial: >- Financial instruments outside the classes above (e.g. funds, bonds, private credit). other_non_financial: >- Non-financial real-world assets (e.g. tokenized real estate, carbon credits, collectibles). unknown: Identified as a likely RWA, specific class still pending. ResponseMany-2: type: object required: - links - data properties: links: $ref: '#/components/schemas/ResponseManyLinks-2' data: type: array items: $ref: '#/components/schemas/Container-13' ResponseManyLinks-2: type: object required: - self properties: self: type: string format: url example: https://api.zerion.io/v1/fungibles/ first: type: string format: url example: https://api.zerion.io/v1/fungibles/ next: type: string format: url example: https://api.zerion.io/v1/fungibles/ prev: type: string format: url example: https://api.zerion.io/v1/fungibles/ Container-13: type: object description: Object, representing fungible asset. required: - type - id properties: type: type: string description: Fungible resource type example: fungibles id: type: string description: Fungible unique identifier example: '0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6' attributes: $ref: '#/components/schemas/Attributes-11' relationships: $ref: '#/components/schemas/Relationships-6' Attributes-11: type: object required: - name - symbol - flags - external_links - implementations - market_data properties: name: type: string description: Displayable name of the fungible. example: Bankless BED Index symbol: type: string description: Displayable symbol of the fungible. example: BED asset_class: $ref: '#/components/schemas/AssetClass' description: type: string nullable: true description: Brief description of the fungible. example: The BED index is meant to track crypto's top 3 investab. icon: $ref: '#/components/schemas/Icon' flags: $ref: '#/components/schemas/Flags' external_links: $ref: '#/components/schemas/ExternalLinks' implementations: type: array description: Implementation details of the fungible on various chains. items: $ref: '#/components/schemas/AttributesImplementation' market_data: $ref: '#/components/schemas/MarketData' Relationships-6: type: object required: - chart_hour - chart_day - chart_week - chart_month - chart_year - chart_max properties: chart_hour: type: object required: - links - data properties: links: type: object required: - related properties: related: format: url example: >- https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/hour data: type: object required: - type - id properties: type: type: string example: fungible_charts id: type: string example: 0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-hour chart_day: type: object required: - links - data properties: links: type: object required: - related properties: related: format: url example: >- https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/day data: type: object required: - type - id properties: type: type: string example: fungible_charts id: type: string example: 0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-day chart_week: type: object required: - links - data properties: links: type: object required: - related properties: related: format: url example: >- https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/week data: type: object required: - type - id properties: type: type: string example: fungible_charts id: type: string example: 0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-week chart_month: type: object required: - links - data properties: links: type: object required: - related properties: related: format: url example: >- https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/month data: type: object required: - type - id properties: type: type: string example: fungible_charts id: type: string example: 0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-month chart_year: type: object required: - links - data properties: links: type: object required: - related properties: related: format: url example: >- https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/year data: type: object required: - type - id properties: type: type: string example: fungible_charts id: type: string example: 0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-year chart_max: type: object required: - links - data properties: links: type: object required: - related properties: related: format: url example: >- https://api.zerion.io/v1/fungibles/0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6/charts/max data: type: object required: - type - id properties: type: type: string example: fungible_charts id: type: string example: 0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6-max Icon: type: object description: Icon related to object. properties: url: type: string nullable: true format: url description: URL of the icon. example: >- https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png Flags: type: object required: - verified properties: verified: type: boolean description: Whether this fungible verified or not example: true ExternalLinks: type: array description: A list of relevant URLs. items: $ref: '#/components/schemas/ExternalLink' AttributesImplementation: type: object required: - chain_id - address - decimals properties: chain_id: type: string description: Unique id of the chain. example: ethereum address: type: string nullable: true description: >- Implementation address on the chain. Empty (`""`) for the chain's native asset (for example ETH on Ethereum, HYPE on HyperEVM), which has no contract address. To look a native asset up, use `GET /v1/fungibles/by-implementation?implementation=` or the chain's `native_fungible` relationship on `GET /v1/chains/{chain_id}`. Note: `fungible_info.implementations[]` on wallet endpoints returns `null` for the same case. example: '0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6' decimals: type: integer description: Number of decimals points of the implementation. example: 18 market_data: $ref: '#/components/schemas/ImplementationMarketData' deployment_date: type: string format: date-time description: >- Date and time when the token contract was deployed on this chain (ISO 8601). example: '2020-09-09T11:11:13Z' MarketData: type: object required: - price properties: total_supply: type: number format: double description: Total market supply of fungible example: 29905.762448515918 circulating_supply: type: number format: double description: Circulating value of fungible example: 29905.762448515918 fully_diluted_valuation: type: number format: double description: Total market capitalization of fungible in selected currency example: 3196313.736038149 market_cap: type: number format: double description: Circulating market capitalization of fungible in selected currency example: 3196313.736038149 price: type: number nullable: true format: double description: Latest fungible price example: 106.87952669793131 changes: $ref: '#/components/schemas/MarketDataChanges' trading_volumes: $ref: '#/components/schemas/TradingVolumes' ExternalLink: type: object required: - url properties: type: type: string description: Type of the link example: website name: type: string description: Displayable name of the link example: Website url: type: string format: url description: Link to the external resource example: https://www.indexcoop.com ImplementationMarketData: type: object properties: trading_volumes: $ref: '#/components/schemas/TradingVolumes' MarketDataChanges: type: object properties: percent_1d: type: number nullable: true format: double description: Price relative change in percent for 1 day example: -0.7379066649086338 percent_30d: type: number nullable: true format: double description: Price relative change in percent for 30 days example: -2.499465618806962 percent_90d: type: number nullable: true format: double description: Price relative change in percent for 90 days example: 11.316340269371775 percent_365d: type: number nullable: true format: double description: Price relative change in percent for 1 year example: null TradingVolumes: type: object properties: volume_1d: type: number format: double description: Trading volume over the last 24 hours in the selected currency. example: 40096375.69294812 securitySchemes: APIKeyBasicAuth: type: http scheme: basic description: >- To test endpoints here, paste your API key from the [Dashboard](https://dashboard.zerion.io/) into the username field and leave the password empty. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.