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

Field

Description

Type(s)

fungible_id

Unique identifier for a fungible (chain.contract_address for EVM chains, chain.mint_address for Solana, chain.rune_id for Bitcoin)

string

name

Name of the fungible

string / null

chain

Name of the blockchain (e.g., ethereum)

string

decimals

Number of decimals

string / null

previews

Set 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_url

URL to cached image file on the SimpleHash CDN if available

string / null

image_properties

Image properties if available

{
width:int / null,
height: int / null,
size : int / null,
mime_type: str / null,
exif_orientation: int / null,
} / null

created_date

Fungible created datetime

string / null

created_by

Fungible created transaction initiator

string / null

supply

Fungible total supply

string / null

holder_count

Known number of holders for this token

int / null

extra_metadata

JSON field containing the additional custom metadata fields for the fungible token.

{
...,
`
}