GET
/
addressBook
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/addressBook
{
  "name": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "website": "<string>",
  "address": "<string>"
}

The addressBook endpoint retrieves information about a specific address from the TON blockchain’s address book. This can be useful for identifying known entities or contracts on the network.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

Parameters

  • address (string, required) — The address to look up in the address book. This should be a raw address format. Example: 0:ed1691307050047117b998b561d8de82d31fbf84910ced6eb5fc92e7485ef8a7.

Response

  • name (string) — The name associated with the address, if available.
  • description (string) — A description of the address or the entity it represents.
  • icon (string) — URL of an icon associated with the address or entity.
  • website (string) — Website associated with the address or entity.
  • address (string) — The queried address, confirming the lookup.

Use case

The addressBook endpoint can be used in various scenarios:

  1. Wallet applications can use it to display human-readable names and descriptions for known addresses.
  2. Block explorers can enhance their UI by showing additional information about significant addresses.
  3. DApps can use it to verify if they’re interacting with known, trusted contracts or entities.

Query Parameters

address
string
default:0:ed1691307050047117b998b561d8de82d31fbf84910ced6eb5fc92e7485ef8a7
required

The address to look up in the address book

Response

200 - application/json
Successful response
name
string

The name associated with the address

description
string

A description of the address or associated entity

icon
string

URL of an icon associated with the address

website
string

Website associated with the address

address
string

The queried address