Blockchain API

Contracts

Look up a token by its contract address and get what it is: its standard, name, symbol, decimals and total supply, on EVM chains and Solana.

Start free trial Read the docs

Look up by contract address Name, symbol and decimals EVM chains and Solana

What you can build

Token details for wallets, explorers and listings

Show the right amounts

Read a token's decimals before you display or send an amount, so an amount is never off by a factor of a million.

Name an unknown token

Turn a contract address from a transfer into a name and symbol your users can read.

Check before listing

Confirm a contract's standard and supply before you add the token to your wallet or exchange.

Quick start

Make your first Contracts call

Real paths and example responses from the API reference. Add your API key and run it.

Base URL https://rest.cryptoapis.io
Auth: the X-API-Key header
JSON responses, same shape on every chain

curl https://rest.cryptoapis.io/contracts/evm/ethereum/mainnet/CONTRACT_ADDRESS/token-details \
  -H "X-API-Key: YOUR_API_KEY"

200 OKExample response, excerpt

{
  "standard": "ERC-20",
  "name": "Band Protocol",
  "symbol": "AQUA",
  "fungibleValues": {
    "decimals": 6,
    "totalSupply": "1000000"
  }
}

curl https://rest.cryptoapis.io/contracts/solana/mainnet/CONTRACT_ADDRESS/token-details \
  -H "X-API-Key: YOUR_API_KEY"

200 OKExample response, excerpt

{
  "collection": {
    "address": "69k55dCTwiUPNgaTZ8FVMADorTvEGJEGuAGEB7m1qB1S",
    "verified": "true"
  },
  "description": "A Community Brand Capturing the Spirit of Perseverance and Ambition, in Style",
  "image": "https://ipfs.io/ipfs/QmQ5TWTtXoKeupMucMUuss8pCbt3ZyyfV3frCKPjzzJXQf/8877.png",
  "name": "BoDoggos #8877"
}

Endpoints

Every Contracts endpoint

Each operation links to its page in the API reference, with its parameters and responses. Paths take the blockchain and the network, so moving to another chain is a change of path.

API reference

What it does

Method and path

Blockchains

Reference

Get Token Details by Contract Address EVM

GET/contracts/evm/{blockchain}/{network}/{contractAddress}/token-details

3 blockchains

Docs

Get Token Details by Contract Address Solana

GET/contracts/solana/{network}/{contractAddress}/token-details

Solana

Docs

Blockchains

Contracts works on 4 blockchains

Mainnets, and test networks where the chain has one. Open a chain for its own endpoints and quick start.

See all networks

Ethereum

Ethereum Classic

BNB Smart Chain

Solana

Pairs well with

Build the rest of the flow

All Blockchain API features

Transactions DataAny transaction by hash, with its transfers Address LatestBalance and recent transactions of any address, no setup Market DataExchange rates and asset details

FAQ

Contracts questions

Which blockchains does Contracts support?

Contracts works on 4 blockchains: Ethereum, Ethereum Classic, BNB Smart Chain, Solana. Each chain's page lists its networks and its own endpoints.

Can I try Contracts for free?

Yes, for 14 days. The Blockchain API free trial includes Contracts and every other feature, with no card. It ends after 14 days or when its credits run out; after that, calls need a subscription, listed on the pricing page.

Does the CryptoAPIs Contracts API support Solana tokens?

Yes. There is a dedicated Solana endpoint that returns token details by contract address on Solana mainnet and devnet. It is a separate route from the EVM endpoint, so Solana SPL token metadata is supported directly.

What token metadata can I get from a contract address?

For a given token contract address you can retrieve the token's name, symbol, standard, decimals, and total supply. This is the core capability of the Get Token Details by Contract Address endpoint. It is a read-only metadata lookup, not a full contract source or ABI download.

Can I decode a contract ABI or read arbitrary contract state with this API?

No. The Contracts product is scoped to retrieving token metadata (name, symbol, standard, decimals, total supply) by contract address. It does not expose ABI decoding, source code, event log decoding, or arbitrary read-calls to contract methods. For broader on-chain data, CryptoAPIs offers separate transactions data and blockchain data services.

Start building with Contracts

14-day free trial, mainnet included. No card needed.

Start free trial Talk to sales