/nft/:name
GET
/nft/{name}ERC-721 metadata for a registered ArcNS name: description, an SVG card as a data: URI, external_url and attributes (namespace, handle type, tokenized, rarity, bucket, length, registry). Call when rendering a name as a collectible or listing. 404 when the name is not registered.
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/nft/@alice"{ "name": "@alice", "description": "@alice is a registered name on the ArcNS @handle registry (Arc chain 5042002; 5 characters, Rare tier). It is transferable: holding the token is the sole authority over the name and it trades on any ERC-721 marketplace.", "image": "data:image/svg+xml;base64,PHN2Zy…", "external_url": "https://app.arcns.io/name/@alice", "attributes": [ { "trait_type": "Namespace", "value": "handle" } ], "chainId": 5042002, "blockNumber": 1000, "registry": "0x1000000000000000000000000000000000000001", "namespace": "handle", "input": "@alice"}