Address labels (batch)

Label 1–200 addresses of one chain in a single request. Results come back in input order; duplicates stay separate positions.

POSThttps://triport.io/v1/intelligence/labels/batch

Network: Ethereum, Solana, Avalanche C-Chain
Scope: intelligence:read
Auth: x-token: $TRIPORT_API_KEY header (or Authorization: Bearer)
Rate limit: Business — 30 rps (intelligence, burst ×2); Enterprise — 150 rps

Request

cURLJavaScriptPython

curl -X POST "https://triport.io/v1/intelligence/labels/batch" \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"eth","addresses":["0xdac17f958d2ee523a2206206994597c13d831ec7","0x7a250d5630b4cf539739df2c5dacd4c659f2488d"]}'

const res = await fetch("https://triport.io/v1/intelligence/labels/batch", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "chain": "eth",
    "addresses": [
      "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "0x7a250d5630b4cf539739df2c5dacd4c659f2488d"
    ]
  }),
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.post(
    "https://triport.io/v1/intelligence/labels/batch",
    headers={
        "x-token": os.environ["TRIPORT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "chain": "eth",
        "addresses": [
            "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "0x7a250d5630b4cf539739df2c5dacd4c659f2488d",
        ],
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "state": "partial",
  "meta": {
    "cached": false,
    "complete": false
  },
  "data": {
    "items": [
      {
        "inputAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "chain": "eth",
        "state": "ok",
        "identity": {
          "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "chain": "eth",
          "chainId": "1",
          "label": "Tether: USDT Stablecoin"
        },
        "meta": {
          "observedAt": "2026-11-06T09:19:53.878171426Z",
          "expiresAt": "2026-11-07T09:19:53.878171426Z",
          "cached": true,
          "complete": false
        }
      },
      {
        "inputAddress": "0x7a250d5630b4cf539739df2c5dacd4c659f2488d",
        "address": "0x7a250d5630b4cf539739df2c5dacd4c659f2488d",
        "chain": "eth",
        "state": "partial",
        "meta": {
          "observedAt": "2026-11-06T09:19:53.878171426Z",
          "expiresAt": "2026-11-07T09:19:53.878171426Z",
          "cached": true,
          "complete": false
        }
      }
    ]
  }
}

Label 1–200 addresses of one chain in a single request. Results come back in input order; duplicates stay separate positions.

Each item carries its own state, meta and optional error; read them per item. A missing label is not proof that an address has none. Every address counts as one request against the per-second limit.

Released on Ethereum, Solana, Avalanche C-Chain. Any other chain value answers 422 with state unsupported. More chains are coming; see the changelog.

Every answer is an envelope with state, meta, optional data and optional error. Read state first: ok, empty, partial, stale, unsupported or unavailable (see response states). meta.cached tells you whether the answer came from cache.

Parameters

addressesarray of stringrequired

1–200 addresses of the same chain. Duplicates are kept as separate positions; each position counts as one request against the per-second limit.

chainstringrequired

Chain id, see Network above (eth, and for labels also solana and avalanche). Aliases: ethereum → eth, sol → solana, avax → avalanche.

freshbooleanoptional

Optional. true skips the cache and asks for a new lookup (GET routes: ?fresh=1).

Response

Response recorded on 2026-11-06 through https://triport.io (long lists shortened). Values change over time.

Errors

HTTP	`error.code`	When
400	`invalid_request`	Malformed address, unknown field, `null` value or invalid JSON.
401	`unauthorized`	Missing or invalid API key.
403	`scope_missing` / `tier_insufficient`	The key lacks `intelligence:read`, or the plan is below Business.
405	`method_not_allowed`	Wrong HTTP method; the `Allow` header names `POST`.
422	`unsupported`	The chain (or the contract) is not supported by this method.
429	`rate_limited`	Over the `intelligence` per-second limit; wait `Retry-After` seconds.
503	`unavailable`	The lookup could not be completed right now; retry later.
504	`timeout`	The lookup took too long; retry, or retry later with the same input.

See errors, limits and states for the full rules and the code examples.