> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# metadata | TON v3

> The metadata endpoint queries address metadata from the TON blockchain indexer. Available on TON v3 via Chainstack JSON-RPC nodes.

# Metadata

The `metadata` endpoint queries address metadata from the TON blockchain indexer. This includes human-readable names, scam flags, icons, and other identifying information for known addresses.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## Parameters

* `address` (string, required) — The address to get metadata for.

## Response

* `address` (string) — The queried address.
* `name` (string) — Human-readable name for the address (if known).
* `is_scam` (boolean) — Whether the address is flagged as a scam.
* `icon` (string) — URL to the address icon (if available).
* `is_wallet` (boolean) — Whether the address is a wallet contract.

## Use case

The `metadata` endpoint is valuable for improving user experience and security:

1. Wallet applications displaying friendly names instead of raw addresses.
2. Scam detection by checking addresses before sending funds.
3. Block explorers showing rich information about addresses.
4. DApps displaying icons for known contracts and tokens.
5. Security tools identifying potentially malicious addresses.

Here's an example of getting address metadata:

<CodeGroup>
  ```shell shell theme={"system"}
  curl -X GET \
    'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/metadata?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs' \
    -H 'accept: application/json'
  ```
</CodeGroup>

<Warning>
  Always check the `is_scam` flag before interacting with unknown addresses. This can help protect users from known malicious actors on the network.
</Warning>


## OpenAPI

````yaml openapi/ton_node_api/v3/getMetadata.json GET /metadata
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /metadata:
    get:
      tags:
        - Accounts
      summary: Get Metadata
      description: Query address metadata including names and labels
      operationId: getMetadata
      parameters:
        - name: address
          in: query
          description: Address to get metadata for
          required: true
          schema:
            type: string
            default: EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  address:
                    type: string
                    description: The queried address
                  name:
                    type: string
                    description: Human-readable name for the address
                  is_scam:
                    type: boolean
                    description: Whether the address is flagged as scam
                  icon:
                    type: string
                    description: URL to the address icon
                  is_wallet:
                    type: boolean
                    description: Whether the address is a wallet contract

````