Skip to content
Arc Testnet — names have no monetary value yet
ArcNS / /resolve/:name

/resolve/:name

GET/resolve/{name}

Resolve an ArcNS name (@handle, .arc, .circle) on Arc to its owner and explicit payment address, read authoritatively from ArcNS's own registry only. Call before sending funds to a name: every answer carries the namespace and the registry address it was read from, and addr is only ever an explicit resolver record (never the owner). 404 only after a successful chain read proved absence; 502 on any RPC failure.

Path Parameters

name*string

@handle, label.arc or label.circle (percent-encode @ as %40). A mixed shape such as @jack.arc is refused with 409.

Header Parameters

PAYMENT-SIGNATURE?string

base64(JSON x402 v2 PaymentPayload) — the signed authorization for one accepts[] entry of a prior 402.

X-API-Key?string

A free-tier key issued by ArcNS; keyed callers are never charged.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/resolve/@alice"
{  "input": "@alice",  "name": "@alice",  "namespace": "handle",  "registry": "0x1000000000000000000000000000000000000001",  "resolver": "0x1000000000000000000000000000000000000004",  "chainId": 5042002,  "blockNumber": 1000,  "epoch": 3,  "owner": "0xAAAA0000000000000000000000000000000000A1",  "addr": {    "coinType": 2153111378,    "address": "0xAAAA0000000000000000000000000000000000A2",    "verified": true  },  "tokenized": true,  "locked": false,  "handleType": "Human",  "expires": null}

Browse the docs