Skip to main content

Explorer API

info

Some of our Legacy Explorer endpoints will be deprecated from 30 Jan 2024 onwards. Please read here for further information.

The Cloud Explorer API currently offers the following functionality:

Listings​

By default listings endpoints return all data for provided type. You can use following query params to return paginated data or search for a specific listing by its name:

ParamRequired?Description
projectIdRequiredYour WalletConnect Cloud Project ID (from cloud.walletconnect.com)
entriesSpecifies how many entries will be returned (must be used together with page param)
pageSpecifies current page (must be used with entries param)
searchReturns listings whose name matches provided search query
idsReturns listings whose id matches provided ids (e.g. &ids=LISTING_ID1,LISTING_ID2)
chainsReturns listings that support at least one of the provided chains
(e.g. ?chains=eip155:1,eip155:137)
platformsReturns listings that support at least one of the provided platforms
(e.g. ?platforms=ios,android,mac,injected)
sdksReturns listings that support at least one of the provided WalletConnect SDKs
(e.g. ?sdks=sign_v1,sign_v2,auth_v1)
standardsReturns listings that support at least one of the provided standards
(e.g. ?standards=eip-712,eip-3085)
versionDeprecated - replaced by sdks param. Specifies supported Sign version (1 or 2)

GET /v3/wallets​

Returns a JSON object containing all wallets listed in the cloud explorer.

Examples:

  • GET https://explorer-api.walletconnect.com/v3/wallets?projectId=YOUR_PROJECT_ID&entries=5&page=1 (will return the first 5 wallets from the first page)
  • GET https://explorer-api.walletconnect.com/v3/wallets?projectId=YOUR_PROJECT_ID&platforms=injected (will only return injected wallets)

GET /v3/dapps​

Returns a JSON object containing all dApps listed in the public cloud explorer.

Examples:

  • GET https://explorer-api.walletconnect.com/v3/dapps?projectId=YOUR_PROJECT_ID&entries=5&page=1

GET /v3/hybrid​

Returns a JSON object containing all hybrids listed in the public cloud explorer.

Examples:

  • GET https://explorer-api.walletconnect.com/v3/hybrid?projectId=YOUR_PROJECT_ID&entries=5&page=1

GET /v3/all​

Returns a JSON object containing all entries listed in the public cloud explorer.

Examples:

  • GET https://explorer-api.walletconnect.com/v3/all?projectId=YOUR_PROJECT_ID&entries=5&page=1

GET /v3/all?projectId=YOUR_PROJECT_ID&ids=LISTING_ID1,LISTING_ID2​

Returns a JSON object containing the entry listings by ID, which can be useful for allowlisting purposes.
You can find and copy listing ids from our Explorer

Examples:

  • GET https://explorer-api.walletconnect.com/v3/all?projectId=YOUR_PROJECT_ID&ids=be49f0a78d6ea1beed3804c3a6b62ea71f568d58d9df8097f3d61c7c9baf273d,4622a2b2d6af1c9844944291e5e7351a6aa24cd7b23099efac1b2fd875da31a0

Chains​

By default chains endpoint returns all chains registered under CASA Namespace and that were approved by following our Add Chain issue template

Query Parameters​

You can use following query params to query chains by its namespace and exclude testnets:

ParamDescription
testnetsDetermines if testnets should be included in the response
(e.g. ?testnets=false, defaults to true if not provided)
namespacesReturns chains that belong to one of the provided namespaces
(e.g. ?namespaces=eip155,cosmos,solana)

GET /v3/chains​

Returns all chains registered under CASA Namespace and that were approved by following our Add Chain issue template

Examples:

  • GET https://explorer-api.walletconnect.com/v3/chains?projectId=YOUR_PROJECT_ID
  • GET https://explorer-api.walletconnect.com/v3/chains?projectId=YOUR_PROJECT_ID&testnets=false
  • GET https://explorer-api.walletconnect.com/v3/chains?projectId=YOUR_PROJECT_ID&namespaces=eip155,cosmos

Logos​

Path Parameters​

ParamDescription
sizeDetermines resolution of returned image can be one of: sm, md or lg
idCorresponds to a Cloud Explorer entry's image_id field as returned by the Listings API

Query Parameters​

ParamRequired?Description
projectIdRequiredYour WalletConnect Cloud Project ID (from cloud.walletconnect.com)

GET /v3/logo/:size/:image_id​

Returns the image source of the logo for image_id sized according size.

Examples:

  • GET https://explorer-api.walletconnect.com/v3/logo/md/32a77b79-ffe8-42c3-61a7-3e02e019ca00?projectId=YOUR_PROJECT_ID

Legacy Endpoints​

As part of our ongoing commitment to providing secure, efficient, and up-to-date services, we are announcing the deprecation of certain legacy endpoints within the Explorer API.

Why are we deprecating these endpoints?​

These endpoints are legacy artifacts from the WalletConnect Protocol v1.0 era. The decision to deprecate these endpoints is driven by our commitment to maintaining the highest standards of security, performance, and scalability.

What does this mean for you?​

This deprecation only affects you if you are still relying on: registry.walletconnect.ORG and/or the affected endpoints listed below

The following will no longer be supported from 1pm (13:00) GMT on January 30, 2024 onwards.

Affected domains​

The registry.walletconnect.org subdomain will be shut down, while the registry subdomain on .com (i.e. registry.walletconnect.com) will continue to operate

Affected endpoints​

/data/{type}.json

https://registry.walletconnect.org/data/wallets.json

/logo/{size}/{id}

https://registry.walletconnect.org/logo/md/c57ca95b47569778a828d19178114f4db188b89b763c899ba0be274e97267d96.jpeg

/v1/logo/{size}/{id} and /api/v1/logo/{size}/{id} https://registry.walletconnect.com/api/v1/logo/md/d01c7758d741b363e637a817a09bcf579feae4db9f5bb16f599fdd1f66e2f974

https://registry.walletconnect.com/v1/logo/md/d01c7758d741b363e637a817a09bcf579feae4db9f5bb16f599fdd1f66e2f974

/v1/{type}

https://registry.walletconnect.com/v1/wallets

https://registry.walletconnect.com/v1/dapps

https://registry.walletconnect.com/v1/all

/v2/logo/{size}/{id} and /api/v2/logo/{size}/{id} https://registry.walletconnect.com/api/v2/logo/lg/32a77b79-ffe8-42c3-61a7-3e02e019ca00

https://registry.walletconnect.com/v2/logo/lg/32a77b79-ffe8-42c3-61a7-3e02e019ca00

/v2/{type}

https://registry.walletconnect.com/v2/wallets

https://registry.walletconnect.com/v2/dapps

https://registry.walletconnect.com/v2/all

What do you need to do?​

If you are still using these legacy endpoints, all you need to do is simply upgrade before January 30, 2024. You can do so by updating any custom API requests to:

  • use the /v3/ prefix
  • adding your dapp’s/wallet’s projectId to each request via ?projectId= query parameter

Below are a few upgrade examples that you can refer to.

Upgrade examples​

Scenario 1​

Your dapp is querying the deprecated registry.walletconnect.org/data/wallets.json endpoint for wallet metadata.

Issues:

Solution:

Scenario 2​

Your dapp is querying the deprecated registry.walletconnect.com/v2/wallets endpoint for wallet metadata

Issues:

  • The /v2/wallets endpoint will be shut down.

Solution:

Scenario 3​

Your dapp is querying the deprecated registry.walletconnect.org/logo/{size}/{id}.jpeg endpoint for wallet logos.

Issues:

  • registry.walletconnect.org - the registry...org subdomain will be shut down.
  • The /logo/ endpoints (without /v3/ prefix) will be shut down.

Solution: