Implementation labels

Label the implementation contracts behind 1–200 proxy addresses, so a proxy can be shown together with the code it delegates to.

POSThttps://triport.io/v1/intelligence/implementation-labels

Network: Ethereum
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/implementation-labels" \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"eth","addresses":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]}'

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

import os


import requests


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

Response

JSON

Example

{
  "state": "ok",
  "meta": {
    "cached": false,
    "complete": false
  },
  "data": {
    "items": [
      {
        "inputAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "chain": "eth",
        "state": "ok",
        "identity": {
          "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "chain": "eth",
          "chainId": "1",
          "label": "Circle: USDC Token",
          "implementation": {
            "address": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
            "label": "Circle: Fiat Token V2_2"
          }
        },
        "meta": {
          "observedAt": "2026-11-06T09:20:04.38067221Z",
          "expiresAt": "2026-11-07T09:20:04.38067221Z",
          "cached": true,
          "complete": false
        }
      }
    ]
  }
}

Label the implementation contracts behind 1–200 proxy addresses, so a proxy can be shown together with the code it delegates to.

The implementation's label describes the implementation, not the proxy's owner. Do not copy it onto the proxy address. Every address counts as one request against the per-second limit.

Released on Ethereum. 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.