Search
Find addresses, tokens, blocks, transactions and contracts by name or identifier. Blockscout API v2 paths, served for every chain with a public Routescan API. Requests need the key of a paid plan, see Authentication.
Search
Full search, paginated, across tokens, addresses, contracts, blocks and transactions.
GET
https://blockscout.routescan.io/{chainId}/api/v2/searchGET
https://blockscout.routescan.io/1/api/v2/search?q=usdt&apikey=YourApiKeyToken1curl 'https://blockscout.routescan.io/1/api/v2/search?q=usdt' \
2 -H 'x-api-key: YourApiKeyToken'
1{
2 items: {
3 type: string;
4 name: string;
5 symbol: string;
6 address_hash: string;
7 token_url: string;
8 address_url: string;
9 icon_url: string;
10 token_type: string;
11 is_smart_contract_verified: boolean;
12 exchange_rate: string;
13 total_supply: string;
14 circulating_market_cap: string;
15 is_verified_via_admin_panel: boolean;
16 certified: boolean;
17 priority: number;
18 reputation: string;
19 is_smart_contract_address: boolean;
20 }[];
21 next_page_params: {
22 cursor: string;
23 };
24}
Example response (Ethereum, lists cut to their first item)
jsonCopy code
1{
2 "items": [
3 {
4 "type": "token",
5 "name": "Tether USD",
6 "symbol": "USDT",
7 "address_hash": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
8 "token_url": "/token/0xdAC17F958D2ee523a2206206994597C13D831ec7",
9 "address_url": "/address/0xdAC17F958D2ee523a2206206994597C13D831ec7",
10 "icon_url": "https://cms-cdn.avascan.com/cms2/usdt-tether-logo.d57b7dec617b.png",
11 "token_type": "ERC-20",
12 "is_smart_contract_verified": true,
13 "exchange_rate": "0.999102",
14 "total_supply": "88301265725970534",
15 "circulating_market_cap": "88221887230.68462",
16 "is_verified_via_admin_panel": false,
17 "certified": false,
18 "priority": 2,
19 "reputation": "ok",
20 "is_smart_contract_address": true
21 }
22 ],
23 "next_page_params": {
24 "cursor": "7b2276223a312c2273636f7065223a227365617263683a6d61696e6e65743a313a75736474222c226b223a5b223530225d7d"
25 }
26}
Quick search
Top matches for a search term, unpaginated, for autocomplete.
GET
https://blockscout.routescan.io/{chainId}/api/v2/search/quickGET
https://blockscout.routescan.io/1/api/v2/search/quick?q=usdt&apikey=YourApiKeyToken1curl 'https://blockscout.routescan.io/1/api/v2/search/quick?q=usdt' \
2 -H 'x-api-key: YourApiKeyToken'
1{
2 type: string;
3 name: string;
4 symbol: string;
5 address_hash: string;
6 token_url: string;
7 address_url: string;
8 icon_url: string;
9 token_type: string;
10 is_smart_contract_verified: boolean;
11 exchange_rate: string;
12 total_supply: string;
13 circulating_market_cap: string;
14 is_verified_via_admin_panel: boolean;
15 certified: boolean;
16 priority: number;
17 reputation: string;
18 is_smart_contract_address: boolean;
19}[]
Example response (Ethereum, lists cut to their first item)
jsonCopy code
1[
2 {
3 "type": "token",
4 "name": "Tether USD",
5 "symbol": "USDT",
6 "address_hash": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
7 "token_url": "/token/0xdAC17F958D2ee523a2206206994597C13D831ec7",
8 "address_url": "/address/0xdAC17F958D2ee523a2206206994597C13D831ec7",
9 "icon_url": "https://cms-cdn.avascan.com/cms2/usdt-tether-logo.d57b7dec617b.png",
10 "token_type": "ERC-20",
11 "is_smart_contract_verified": true,
12 "exchange_rate": "0.999102",
13 "total_supply": "88301265725970534",
14 "circulating_market_cap": "88221887230.68462",
15 "is_verified_via_admin_panel": false,
16 "certified": false,
17 "priority": 2,
18 "reputation": "ok",
19 "is_smart_contract_address": true
20 }
21]
Check search redirect
Whether a search term resolves to a single entity page (address, block or transaction).
GET
https://blockscout.routescan.io/{chainId}/api/v2/search/check-redirectGET
https://blockscout.routescan.io/1/api/v2/search/check-redirect?q=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&apikey=YourApiKeyToken1curl 'https://blockscout.routescan.io/1/api/v2/search/check-redirect?q=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' \
2 -H 'x-api-key: YourApiKeyToken'
1{
2 parameter: string;
3 redirect: boolean;
4 type: string;
5}
Example response (Ethereum, lists cut to their first item)
jsonCopy code
1{
2 "parameter": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
3 "redirect": true,
4 "type": "address"
5}