routheus-xyz Tokens API
The Tokens API from routheus-xyz — 2 operation(s) for tokens.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/routheus-xyz:routheus-xyz-tokens-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Routheus Tokens API
description: 'Live DEX token prices and best-route swap quotes across 13 EVM chains (Base, Ethereum, Arbitrum, BSC, Optimism, Polygon and more). Sub-millisecond answers from our own real-time pool-state engine, not a proxy. Executable swap calldata (Permit2), simulation-verified quotes, chained-state arb quoting, token metadata, token search, DEX pools. For AI agents: pay per call in USDC on Base, Polygon, Arbitrum, Avalanche or Solana via x402 — no API keys, no subscription. From $0.001 per call; failed answers are free.'
version: 1.0.0
contact:
email: contact@routheus.xyz
servers:
- url: https://routheus.xyz
tags:
- name: Tokens
paths:
/{chain}/api/tokens/metadata:
get:
summary: 'Token metadata: decimals, name, symbol, balance storage slot (cache-only)'
x-payment-info:
intent: charge
method: x402
protocol: x402
mode: fixed
currency: USD
amount: '0.003'
parameters:
- name: chain
in: path
required: true
schema:
type: string
enum:
- arb
- ava
- base
- ber
- bsc
- eth
- gno
- hem
- hyp
- opt
- pol
- rob
- son
- uni
example: base
description: 'Chain: canonical slug, chain name, or EIP-155 id — /eth, /ethereum, /1 all work (see /chain-peers for aliases)'
- name: token
in: query
required: true
schema:
type: string
example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
description: 'Token address (0x…). Example: USDC on Base'
responses:
'200':
description: Metadata or {ok:false} for unknown tokens (not charged)
content:
application/json:
schema:
type: object
required:
- ok
properties:
ok:
type: boolean
error:
type: string
description: Set for unknown tokens (never charged)
data:
type: object
properties:
token:
type: string
decimals:
type: integer
name:
type: string
symbol:
type: string
balance_slot:
type: object
description: Storage slot info for eth_call balance overrides
properties:
slot_type:
type: string
slot_number:
type: integer
example:
ok: true
data:
token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
decimals: 6
name: USD Coin
symbol: USDC
balance_slot:
slot_type: solidity
slot_number: 9
'402':
description: Payment required (x402 v1 + v2). The v1 offer is the JSON body's `accepts` array (one entry per payment network — USDC on Base/Polygon/Arbitrum/Avalanche/Solana; retry with the X-PAYMENT header); the same offer is in the base64 PAYMENT-REQUIRED response header for v2 clients (retry with PAYMENT-SIGNATURE).
content:
application/json: {}
tags:
- Tokens
operationId: getByChainApiTokensMetadata
x-operation-id-source: derived
/{chain}/api/tokens/search:
get:
summary: Search indexed tokens by address, symbol or name
x-payment-info:
intent: charge
method: x402
protocol: x402
mode: fixed
currency: USD
amount: '0.003'
parameters:
- name: chain
in: path
required: true
schema:
type: string
enum:
- arb
- ava
- base
- ber
- bsc
- eth
- gno
- hem
- hyp
- opt
- pol
- rob
- son
- uni
example: base
description: 'Chain: canonical slug, chain name, or EIP-155 id — /eth, /ethereum, /1 all work (see /chain-peers for aliases)'
- name: query
in: query
required: true
schema:
type: string
example: USDC
description: Address, symbol or name fragment
- name: page
in: query
required: false
schema:
type: string
description: Page number
- name: page_size
in: query
required: false
schema:
type: string
description: Page size
responses:
'200':
description: Paginated token matches with pool counts
content:
application/json:
schema:
type: object
required:
- ok
properties:
ok:
type: boolean
total:
type: integer
page:
type: integer
page_size:
type: integer
total_pages:
type: integer
tokens:
type: array
items:
type: object
properties:
address:
type: string
symbol:
type: string
name:
type: string
decimals:
type: integer
pool_count:
type: integer
example:
ok: true
total: 139
page: 1
page_size: 20
total_pages: 7
tokens:
- address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
symbol: USDC
name: USD Coin
decimals: 6
pool_count: 12062
'402':
description: Payment required (x402 v1 + v2). The v1 offer is the JSON body's `accepts` array (one entry per payment network — USDC on Base/Polygon/Arbitrum/Avalanche/Solana; retry with the X-PAYMENT header); the same offer is in the base64 PAYMENT-REQUIRED response header for v2 clients (retry with PAYMENT-SIGNATURE).
content:
application/json: {}
tags:
- Tokens
operationId: getByChainApiTokensSearch
x-operation-id-source: derived