Skip to main content

Explorer API

The Cloud Explorer API currently offers the following functionality:

  • Listings - Allows for fetching of wallets and dApps listed in the Reown Cloud Explorer.
  • Logos - Provides logo assets in different sizes for a given Cloud explorer entry.

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 Reown Cloud Project ID (from cloud.reown.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 Reown 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 Reown Cloud Project ID (from cloud.reown.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