accounts

Resolve TON DNS name

Recursively resolve a TON DNS domain into all records. Supports .ton, .t.me, and delegated subdomains. When resolver_address is omitted, discover the root from on-chain config parameter 4. Root discovery and all resolver calls use the same masterchain block, selected by seqno or the current state.

get/api/v2/dnsResolve

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/dnsResolve
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

domainstring required

Domain to resolve; relative to resolver_address when supplied. Case-insensitive; a trailing dot is accepted.

resolver_addressstring

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

Starting resolver address. Defaults to on-chain config parameter 4 at the selected block.

seqnointeger

Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.

Response

OK

okboolean required

Returns true if the request succeeded; otherwise false. See the error field for details.

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.