> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superform.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# List Fungibles

> Returns compact chain-independent fungible market summaries with case-insensitive id, name, and symbol search plus exact case-insensitive token-address matching, optional chain_ids filtering, and market-cap, price, one-day price-change, or alphabetical sorting across the eligible canonical catalog before pagination. Chain-native implementations use token IDs with address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee. Explicitly denied tokens and Vault or SuperVault share contracts are excluded from token_ids and catalog eligibility; canonical identities with no remaining eligible implementation are omitted. Missing market values are omitted and sort after available values.



## OpenAPI

````yaml https://persephone.superform.xyz/openapi.json get /v1/fungibles
openapi: 3.1.0
info:
  title: Superform API
  description: API for interacting with the Superform platform
  version: 33.2.0
  contact:
    name: Superform Team
    url: https://superform.xyz
servers:
  - url: https://persephone.superform.xyz
security:
  - SF-API-KEY: []
tags:
  - name: RestAPIService
paths:
  /v1/fungibles:
    get:
      tags:
        - fungibles
      summary: List Fungibles
      description: >-
        Returns compact chain-independent fungible market summaries with
        case-insensitive id, name, and symbol search plus exact case-insensitive
        token-address matching, optional chain_ids filtering, and market-cap,
        price, one-day price-change, or alphabetical sorting across the eligible
        canonical catalog before pagination. Chain-native implementations use
        token IDs with address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee.
        Explicitly denied tokens and Vault or SuperVault share contracts are
        excluded from token_ids and catalog eligibility; canonical identities
        with no remaining eligible implementation are omitted. Missing market
        values are omitted and sort after available values.
      operationId: RestAPIService_ListFungibles
      parameters:
        - name: page_size
          description: Number of fungibles to return per page (default 100, maximum 500)
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: '100'
        - name: page
          description: Page number to retrieve (1-based)
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: '1'
        - name: search
          description: >-
            Search fungibles by id, name, or symbol, or by an exact token
            contract address (case-insensitive)
          in: query
          required: false
          schema:
            type: string
        - name: sort_by
          description: >-
            Sort by field: market_cap, price, price_change_1d, volume_24h,
            deployed_at, or alphabetical
          in: query
          required: false
          schema:
            type: string
            default: market_cap
        - name: sort_dir
          description: >-
            Sort direction: asc or desc (defaults to asc for alphabetical and
            desc otherwise)
          in: query
          required: false
          schema:
            type: string
        - name: chain_ids
          description: >-
            Filter to fungibles with at least one eligible token_id on any of
            these chains
          in: query
          required: false
          explode: true
          schema:
            type: array
            items:
              type: string
              format: uint64
        - name: min_fdv_usd
          description: >-
            Only return fungibles whose fully-diluted valuation is at least this
            many USD. Falls back to market cap when FDV is unavailable or zero;
            rows with neither are excluded. Quantized to three significant
            digits, rounding down so the bound only widens. 0 or absent disables
            the filter.
          in: query
          required: false
          schema:
            type: number
            format: double
        - name: max_fdv_usd
          description: >-
            Only return fungibles whose fully-diluted valuation is at most this
            many USD. Falls back to market cap when FDV is unavailable or zero;
            rows with neither value are included so brand-new, unsized fungibles
            survive a cap filter. Combine with min_fdv_usd to form an explicit
            band, which excludes unsized rows. Quantized to three significant
            digits, rounding up so the bound only widens. 0 or absent disables
            the filter.
          in: query
          required: false
          schema:
            type: number
            format: double
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/restListFungiblesResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
components:
  schemas:
    restListFungiblesResponse:
      type: object
      properties:
        fungibles:
          type: array
          items:
            $ref: '#/components/schemas/commonMarketSummary'
        total_count:
          type: string
          format: int64
        page:
          type: integer
          format: int32
        page_size:
          type: integer
          format: int32
    rpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
    commonMarketSummary:
      type: object
      properties:
        id:
          type: string
        symbol:
          type: string
        name:
          type: string
        icon:
          type: string
        token_ids:
          type: array
          items:
            type: string
          description: >-
            Active token implementation identifiers accepted by the resource's
            by-token routes, ordered by chain ID and token address.
        deployed_at:
          type: string
          format: date-time
          description: >-
            Earliest known contract deployment across the asset's
            implementations; later bridge deployments do not make an old asset
            look new. Omitted when no implementation has a known deploy time.
        market:
          $ref: '#/components/schemas/commonMarketFields'
      required:
        - id
        - symbol
        - name
        - icon
        - token_ids
    protobufAny:
      type: object
      properties:
        '@type':
          type: string
      additionalProperties: {}
    commonMarketFields:
      type: object
      properties:
        price_usd:
          type: number
          format: double
        price_change_1d:
          type: number
          format: double
        market_cap_usd:
          type: number
          format: double
        fdv_usd:
          type: number
          format: double
        volume_24h_usd:
          type: number
          format: double
      description: >-
        MarketFields is the canonical reusable set of current market values for
        an

        asset. The values are independently optional because providers may
        publish

        price, market capitalization, FDV, and volume on different cadences.
  securitySchemes:
    SF-API-KEY:
      type: apiKey
      description: >-
        API key required for authentication. Use the value {{v2_api_key}} in
        Postman.
      name: SF-API-KEY
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.