Find a token's contract address by name or ticker

Search a ticker or a token name and get the matching tokens on one chain, each with its 0x-prefixed contract address, from /tokens/search.

GET /v1/onchain/tokens/search?q= matches a ticker or a name against the tokens we know on one chain and returns them ranked: an exact ticker first, then tickers that start with the text, tickers that contain it, then names. Each row carries symbol, name, token_address and a logo URL. The full parameter list is on Token search.

Quick answer

cURL

# the contract address of PEPE on Ethereum
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/tokens/search?q=PEPE&limit=3"

Example response

Captured from the live API on 2026-10-24 at 17:18 UTC, the whole response.

One token matched, so limit=3 returned one row: a short list means few matches, not a cut. token_address is lower-case hex with the 0x prefix and goes straight into the token routes.

Example response

[
  {
    "symbol": "PEPE",
    "name": "PEPE",
    "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "logo": "https://pub-468f7b552e104638ac0daeddde8a6aab.r2.dev/logos/coins/PEPE.png"
  }
]

Variations

By name. Search by the token's name when you do not know the ticker (%20 is the space).

cURL — by name

# tokens whose name matches "Wrapped Ether"
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/tokens/search?q=Wrapped%20Ether&limit=5"

On another chain. The address is the one on the chain you ask for.

cURL — Base

# the AERO token on Base
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/tokens/search?q=AERO&chain=base&limit=3"

Just the address. Print the first match's address, ready for the next call.

cURL — address only

# the address alone
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/tokens/search?q=PEPE&limit=1" \
  | jq -r '.[0].token_address'

Use it. Pass the address to a token route, here the holder ranking.

cURL — next call

# PEPE's top accumulators, by the address the search returned
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders?limit=10"

Before you rely on it

One chain per call, and a wrong chain name is a 400

Each call reads one chain's token list, ethereum by default, so the same ticker on another chain needs its own call. A name outside ethereum, bsc, base and hyperevm is a 400, like the wallet routes; until 2026-10-25 it returned an empty list with a 200.

Only tokens we know, and full names can be missing

The search covers the tokens we map and price, not every contract on the chain, and a contract address passed as q is not matched. For most tokens the registry's name is the ticker itself, not the full name: on 2026-10-24 q=Aerodrome&chain=base returned [] because Aerodrome is stored as AERO. Try the ticker when a full name finds nothing.

Ask your agent

Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words. The token_search tool answers it, free of credits.

Ask your agent

What is the contract address of PEPE on Ethereum?

Find a token's contract address by name or ticker

Quick answer

Example response

Variations

Before you rely on it

Ask your agent

Related