CodeLive

Basename Resolve

Resolves Coinbase Basenames (.base.eth) to Ethereum addresses and back, reading the Base mainnet L2 Resolver on-chain (no gas, no wallet).

$0.00575USDC per call · settled on Base · no subscription, no API key

Overview

Resolves Coinbase Basenames (.base.eth) to Ethereum addresses and back, reading the Base mainnet L2 Resolver on-chain (no gas, no wallet). Forward: pass a basename like 'alice.base.eth' (bare names are auto-suffixed with .base.eth) to get the registered address plus avatar / url / com.twitter / com.github / email / com.discord text records (override with `text_records`). Reverse: pass a 0x address to get the primary basename, if any. Useful for agent-payment flows that need to translate human names to Base addresses. Use it as a basename resolver, .base.eth lookup, Base name service, or on-chain name resolution.

Endpoint

MethodEndpointPriceDescription
POST/v1/marketplace/api/basename-resolve$0.00575Invoke Basename Resolve (Code) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://api.jarvisclaw.ai/v1/marketplace/api/basename-resolve \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://api.jarvisclaw.ai/v1/marketplace/api/basename-resolve \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'
Open in the marketplace

Docs: Getting started · x402 payments · x402 discovery · All APIs