Explorer
Syncing—

Token MetadataService

token-metadata

ERC-20 token facts read on chain. POST JSON {"address": "0x...", "chain_id": 1} or {"symbol": "USDC", "chain_id": 8453} to /v1/token; chains: Ethereum (1), Optimism (10), BNB Chain (56), Polygon (137), Base (8453), Arbitrum (42161). The response is a JSON object with name, symbol (also older bytes32 symbols such as MKR), decimals, total_supply (raw and scaled), is_erc20 and listed_on (whether the token is on the Uniswap Labs Default token list, decimals verified). Symbol lookups use that list and name other tokens with the same symbol. No logos or prices. Live data.

Active Suppliers
2
of 2 ever configured
Service Info
Service ID
token-metadata
Compute Units / Relay
100,000
Active Applications
2
Relay Mining EMA
1 relays
Service Metadata Cardsource: on-chain metadata (LCD)
{10 items
"schema":"pocket-service-card/v1"
"description":"ERC-20 token facts read on chain. POST JSON {"address": "0x...", "chain_id": 1} or {"symbol": "USDC", "chain_id": 8453} to /v1/token; chains: Ethereum (1), Opti..."
"rpc_types":[1 item
0:{4 items
"type":"REST"
"intent":"expected"
"backend_hint":"token-metadata HTTP server on :8080; POST /v1/token (POST / also reaches it through the relay), GET /v1/health + /v1/version."
"notes":"Every response is a JSON object; errors are JSON 4xx with an error field."
}
]
"apis":[1 item
0:"token-metadata-api"
]
"specs":[1 item
0:{4 items
"kind":"openapi"
"api":"token-metadata-api"
"url":"https://services.supnodes.com/specs/token-metadata/openapi.json"
"notes":"Machine-readable OpenAPI 3.0.3 contract for this service, with example requests."
}
]
"access":"public"
"results":"variable"
"serving":{7 items
"backend":"Single-process Python 3 HTTP server, standard library only, behind a RelayMiner (rest backend). No auth toward the backend; callers cannot send headers. Reads t..."
"implementations":[1 item
0:"token-metadata >= 1.0"
]
"docs":"https://services.supnodes.com/specs/token-metadata/README.md"
"min_disk_gb":1
"min_ram_gb":1
"healthcheck":[3 items
0:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/version"
"method":"GET"
}
"expect":{2 items
"json_path":"$.service"
"matches":"^token-metadata$"
}
"notes":"Identity probe: pins the backend to this service so a wrong backend cannot be staked under this id."
}
1:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/health"
"method":"GET"
}
"expect":{2 items
"json_path":"$.status"
"matches":"^ok$"
}
"notes":"Readiness probe."
}
2:{4 items
"rpc_type":"REST"
"request":{3 items
"path":"/v1/token"
"method":"POST"
"body":{2 items
"address":"0xdAC17F958D2ee523a2206206994597C13D831ec7"
"chain_id":1
}
}
"expect":{2 items
"json_path":"$.symbol"
"matches":"^USDT$"
}
"notes":"Functional probe: USDT on Ethereum; four on-chain reads."
}
]
"notes":"Upstream is a public RPC endpoint that may rate-limit. Gateway operators: configure as type passthrough with rpc_types ["rest"]."
}
"docs":"https://services.supnodes.com/specs/token-metadata/README.md"
"updated":"2026-09-26"
}