Reverse Resolve Usage

We are committed to continuous improvement

API Methods

Query Params	Status
address	required	Specify the wallet address to search for the domain or name data.
vendors	optional	You can narrow your search further by specifying one or more supported vendors. Utilize this parameter to target specific vendors for your query. The complete list of supported providers.

1.

We recommend using the asynchronous endpoint to access our API for optimal performance and responsiveness. This approach ensures lightning-fast response times and is ideal for applications requiring real-time data with minimal delays.

Description

Upon receiving the first request, the server will immediately return any data it already has in memory. If the data is incomplete, the server will re-trigger the reverse resolution process in the background. Subsequent requests from the client should be repeated until the server has fully resolved the data and returns completeness: 1, indicating complete data.

The completeness field in the response indicates the level of completeness of the data returned. A value of 0 means the data is incomplete, while a value of 1 indicates that the data is fully complete.

Example Request

GET /resolution/v1/reverse?address=0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5&vendors=ens,sid,lens

Example Response

{
  "data": [
    {
      "domain": "nick.eth",
      "vendor": "ens",
      "fetchedAt": 1691049786092
    },
    {
      "domain": "arachnid.lens",
      "vendor": "lens",
      "fetchedAt": 1691049786092
    }
  ],
  "completeness": 1,
  "processedVendors": [
    "ens",
    "lens",
    "sid"
  ]
}

2. Synchronous Endpoint

Sync endpoint response times are significantly higher than async, so usage of sync endpoint is generally discouraged unless you preciously need it.

Description

The synchronous request method returns full reverse resolution data using single HTTP request, but may have slower response times.

Example Request

GET /resolution/v1/reverse-sync?address=0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5

Example Response

{
  "data": [
    {
      "domain": "nick.eth",
      "vendor": "ens"
    },
    {
      "domain": "arachnid.lens",	
      "vendor": "lens"
    }
  ]
}

Common Response Data

Every mapping from the server includes the fetchedAt field, which indicates the timestamp when data was fetched from blockchain. This information helps you understand the freshness of the data you received from the API. After the fetchedAt timestamp is aged 1 minute, you may need to re-query the API for the latest data.

Conclusion

Resolution API empowers you to leverage user-owned name data effortlessly and efficiently. Whether you require immediate results or optimal performance, our API delivers with lightning speed. Integrate Resolution API into your applications and unlock the full potential of user-owned names and data!