ERC-20 Tokens

getTokenMetadata

Returns name, symbol, decimals, and total supply for an ERC-20 token. Responses are cached for 1 hour. EVM chains only.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getTokenMetadata",
  "params": {
    "chain": "ethereum",
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "blockHeight": 19834521
  },
  "id": 1
}

Parameters

Name	Required	Description
chain	yes	Network slug
address	yes	Token contract address (0x...) e.g. 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
blockHeight	no	Historical EVM block number (archive nodes only) e.g. 19834521

Response Fields

Field	Type
`data`	object
`chain`	string
`address`	string
`blockHeight`	integer
`name`	string
`symbol`	string
`decimals`	integer
`totalSupply`	string

Supported Networks

EthereumPolygonBNB ChainOptimismBaseAvalancheArbitrumGnosisMoonbeamLineaHyperliquid

Try It

Base URL

Chain

address *

blockHeight

JSON-RPC Body

{
  "jsonrpc": "2.0",
  "method": "getTokenMetadata",
  "params": {
    "chain": "ethereum",
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "blockHeight": 19834521
  },
  "id": 1
}

getTokenAllowance

Returns the amount a spender is approved to transfer from an owner's wallet for a specific ERC-20 token. Calls the token contract's allowance(owner, spender) function. Returns both human-readable and raw values, plus an isUnlimited flag. EVM chains only.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getTokenAllowance",
  "params": {
    "chain": "ethereum",
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "spender": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
    "blockHeight": 19834521
  },
  "id": 1
}