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

# Get Fungible Detail By Token

> Returns fungible identity and token mappings for a mapped token id formatted as chainId_address, including chain-native token IDs whose address is 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee. Identity and token mappings remain available when a current Datamat price cannot yet be derived; latest is omitted only in that case. Within latest, market cap, FDV, volume, market observation time, and 1-hour, 1-day, 7-day, and 30-day changes are omitted independently while unavailable. Every token mapping includes its deployment-specific decimals for scaling raw amounts. An explicitly denied token id or one registered as a Vault or SuperVault share contract does not resolve and returns not found. Open is the first canonical stored hourly price of the current UTC day; percentage changes use canonical stored hourly points; the 1-year change falls back to the oldest stored point when a full year is unavailable; and 52-week high/low are sampled-hour extrema over available trailing history. Total supply, circulating supply, and all-time-high price use the required numeric sentinel -1000000 when unavailable.



## OpenAPI

````yaml https://persephone.superform.xyz/openapi.json get /v1/fungibles/by-token/{token_id}
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/by-token/{token_id}:
    get:
      tags:
        - fungibles
      summary: Get Fungible Detail By Token
      description: >-
        Returns fungible identity and token mappings for a mapped token id
        formatted as chainId_address, including chain-native token IDs whose
        address is 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee. Identity and
        token mappings remain available when a current Datamat price cannot yet
        be derived; latest is omitted only in that case. Within latest, market
        cap, FDV, volume, market observation time, and 1-hour, 1-day, 7-day, and
        30-day changes are omitted independently while unavailable. Every token
        mapping includes its deployment-specific decimals for scaling raw
        amounts. An explicitly denied token id or one registered as a Vault or
        SuperVault share contract does not resolve and returns not found. Open
        is the first canonical stored hourly price of the current UTC day;
        percentage changes use canonical stored hourly points; the 1-year change
        falls back to the oldest stored point when a full year is unavailable;
        and 52-week high/low are sampled-hour extrema over available trailing
        history. Total supply, circulating supply, and all-time-high price use
        the required numeric sentinel -1000000 when unavailable.
      operationId: RestAPIService_GetFungibleByToken
      parameters:
        - name: token_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/restGetFungibleResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
components:
  schemas:
    restGetFungibleResponse:
      type: object
      properties:
        fungible:
          $ref: '#/components/schemas/commonFungible'
    rpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
    commonFungible:
      type: object
      properties:
        fungible_id:
          type: string
        symbol:
          type: string
        name:
          type: string
        description:
          type: string
          description: >-
            Plain-text fungible description. Provider-supplied HTML, XML-like
            markup, attributes, comments, declarations, executable content, and
            character entities are normalized before this field is returned.
        icon:
          type: string
          description: >-
            Preferred fungible icon configured on the chain-independent
            identity; when absent, the first non-empty mapped-token icon in
            chain ID and address order is returned.
        metadata_source:
          type: string
        tokens:
          type: array
          items:
            $ref: '#/components/schemas/commonFungibleTokenMapping'
        latest:
          $ref: '#/components/schemas/commonFungibleLatestStats'
      description: Fungible is a stable, chain-independent identity such as "usdc".
    protobufAny:
      type: object
      properties:
        '@type':
          type: string
      additionalProperties: {}
    commonFungibleTokenMapping:
      type: object
      properties:
        token_id:
          type: string
        chain_id:
          type: string
          format: uint64
        token_address:
          type: string
        source:
          type: string
        deployed_at:
          type: string
          format: date-time
        decimals:
          type: integer
          format: int32
          description: >-
            Token decimals for this chain-specific deployment. Use this value to
            scale raw token amounts.
        visibility:
          type: string
          example: listed
          enum:
            - listed
            - hidden
          description: >-
            Visibility of the mapped token. One of: listed or hidden. Current
            public data is listed.
      description: FungibleTokenMapping maps one EVM token to a chain-independent fungible.
      required:
        - decimals
    commonFungibleLatestStats:
      type: object
      properties:
        price_usd:
          type: number
          format: double
        market_cap_usd:
          type: number
          format: double
        fdv_usd:
          type: number
          format: double
        volume_24h_usd:
          type: number
          format: double
        price_change_1d:
          type: number
          format: double
        source:
          type: string
        market_observed_at:
          type: string
          format: date-time
        open_price_usd:
          type: number
          format: double
        price_usd_1h_change:
          type: number
          format: double
        price_usd_7d_change:
          type: number
          format: double
        price_usd_1m_change:
          type: number
          format: double
        price_usd_1y_change:
          type: number
          format: double
        week_52_high_usd:
          type: number
          format: double
        week_52_low_usd:
          type: number
          format: double
        total_supply:
          type: number
          format: double
          description: >-
            CoinGecko-reported total supply measured in tokens, not USD, or
            -1000000 when unavailable.
        circulating_supply:
          type: number
          format: double
          description: >-
            CoinGecko-reported circulating supply measured in tokens, not USD,
            or -1000000 when unavailable.
        all_time_high_price_usd:
          type: number
          format: double
          description: >-
            CoinGecko all-time-high token price in USD, or -1000000 when
            unavailable.
      description: >-
        FungibleLatestStats contains a current Datamat-backed price snapshot and
        the

        independently available market and hourly-history-derived statistics.
      required:
        - price_usd
        - source
        - open_price_usd
        - price_usd_1y_change
        - week_52_high_usd
        - week_52_low_usd
        - total_supply
        - circulating_supply
        - all_time_high_price_usd
  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.