Token Data

Real-time Token and DEX data

SimpleHash provides real-time access to Fungible Token data and market prices across all of the main chains and ecosystems.

Using either our REST API or Kafka Streaming Service, it's easy to get balances, DEX prices and swap info for any Token. This makes it easy to build out user-facing crypto applications, including wallets, portfolio viewers, trading platforms, web3 social networks, tax software, and more.


What kinds of Fungible Tokens are supported?

SimpleHash supports the main Fungible Token standards across the most popular developer ecosystems. Our indexer is generalized, meaning we ingest all tokens automatically, without them needing to be specifically whitelisted or added.

  • EVM chains: All ERC20 tokens on the main EVM compatible chains, including Ethereum itself, and the main L2 networks
  • Solana: All SPL tokens
  • Bitcoin: Bitcoin Runes
  • Aptos: core Fungible token standards

We're routinely adding new chains - visit this page to see the full list: Supported Chains & Testnets


What kinds of Fungible Token data are available?

SimpleHash provides the core primitives of Fungible Token data, to make it easy to build any kind of functionality for different crypto use cases.

  • Balances: Current token balances for all tokens, and all wallets, can be queried using the API endpoints - balance changes are reflected within a few seconds
  • Swap Info & Transfers: All transfers for all fungible tokens are provided, including core details on the transfer such as the swap info and values - historical retention of transfers is 30 days by default, with longer periods available on request for larger workloads.
  • DEX Prices: Both real-time and historical prices for all tokens on supported DEXes are available. Prices are updated within a few seconds. For EVM chains, we currently support the main Uniswap pools (v2 and v3) and on Solana, we support Orca, Meteora and Raydium, plus prices on the Pump.fun and Moonshot launch pads. For Bitcoin Runes, we support prices on Magic Eden.


Are Native Balances available?

Yes - we also support querying the native balance (including USD value) of wallets across all supported chains via this endpoint.


Fungible Model

The SimpleHash API returns fungible data in a standard format. The following are the fields included in the response (or as a list of fungible objects).

FieldDescriptionType(s)
fungible_idUnique identifier for a fungible (chain.contract_address for EVM chains, chain.mint_address for Solana, chain.rune_id for Bitcoin)string
nameName of the fungiblestring / null
chainName of the blockchain (e.g., ethereum)string
decimals Number of decimalsstring / null
previewsSet of URLs to resized preview images of the media, including an opengraph image, and blurhash, where available. Previews are sized to fit the maximum dimension in pixels as follows: (small: 250px, medium: 512px, large: 1000px).

These may be derived from images, videos, or 3D models.
{
image_small_url:string / null,
image_medium_url:string / null,
image_large_url:string / null,
image_opengraph_url:string / null,
blurhash: string / null,
predominant_color: string / null,
}
image_urlURL to cached image file on the SimpleHash CDN if availablestring / null
image_propertiesImage properties if available{
width:int / null,
height: int / null,
size : int / null,
mime_type: str / null,
exif_orientation: int / null,
} / null
created_dateFungible created datetimestring / null
created_byFungible created transaction initiatorstring / null
supplyFungible total supplystring / null
holder_countKnown number of holders for this tokenint / null
extra_metadataJSON field containing the additional custom metadata fields for the fungible token.{
...,
`
}