Skip to main content
POST
resolve_name
Cost: 1 credit per call. Calls that return an error are refunded. See Credits & Pricing.
This example shows the response format. Check resolved and the returned address before continuing; name ownership can change.

Reading the result

  • service is ens for .eth names and sns for .sol names. network is the chain the address belongs to: ethereum or solana.
  • address is the resolved wallet address. Use it only when resolved is true.
  • A name with an unsupported suffix, or a resolver failure, returns {"status": "no_data"}. A supported name that has no record returns data with resolved: false.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional. Your id for this logical request, 1 to 64 characters. A request is charged at most once per key; reusing a key whose request completed or is running returns 409 DUPLICATE_REQUEST without running the tool.

Required string length: 1 - 64
X-Credit-Catalog-Version
string

Optional. The price version you expect to be charged at. If prices have changed, the call returns 409 PRICE_CHANGED and is not charged. Omit it to be charged at the current price.

Required string length: 1 - 32

Body

application/json
name
string
required

Name to resolve, for example vitalik.eth or bonfida.sol.

Response

Name resolution result: name is the normalized query; service (ens or sns) and network (ethereum or solana) identify the resolver; address is the resolved address and resolved reports whether resolution succeeded. Check resolved before using address. An unsupported or unresolvable name returns status no_data.

The response is of type object.