REST & RealtimeAddress Labels

Address Labels

Look up what a Solana address is: an exchange’s hot wallet, cold wallet or deposit address, a custodian, an onramp, a bridge, a protocol, a tip account, a terminal, an infrastructure wallet, or an address on the OFAC SDN list. Each label comes with the facts behind it.

⚠️

Every label carries a tier. verified means the label’s source names the address and an on-chain check confirms what the source says. predicted means it rests on Conyr’s own observations or on a rule’s inference, or that sources disagree. A predicted deposit label is the deposit-sweep rule’s inference, never proof of who controls the funds. Keep the address visible, and keep tier and reason with the name when you present or export a label.

The endpoint requires a Layer 2 API key and the standard Bearer header.

What a label is

These are money labels. A money label names a service by its brand, as its sources do: an exchange, a custodian, an onramp, a protocol, a bridge, a tip account, a terminal or an infrastructure wallet. A company is named (type company) only on Conyr’s own review, with the company’s evidence; a person never is. Deposit addresses are included: an address that sweeps funds into an exchange’s verified wallet carries that exchange’s name with the role Deposit.

An address on the OFAC SDN list carries the mark. sanction gives the list entry and names the party as OFAC writes it: name, and type (individual or entity). Nothing else of the entry is shown. When the mark is all the label holds, entity is null and role is Sanctioned (OFAC SDN). The name is OFAC’s statement, not Conyr’s: the mark is never joined to a person or a company.

People and social handles are not here. They are on /v1/wallet/{address}/identity. When an address’s label names a person or holds only a handle, this route answers label: null and points to it in identity. If that address is also on the SDN list, label is the mark instead, so the sanction always shows.

Where labels come from

The route reads Conyr’s label registry, which joins these sources and keeps the claim each one makes:

SourceWhat it is
Conyr’s curated listConyr’s own list of service wallets
Conyr’s roots listThe funding origins Conyr’s provenance tracing stops at
Conyr’s code listsPrograms, tip accounts, terminal fee wallets and co-signers Conyr’s parsers use; a list built from transactions Conyr parsed is marked (observed)
Exchanges’ own listsOKX’s, Binance’s and Bybit’s proof of reserves, and Backpack’s, Bitfinex’s and Bitstamp’s wallet lists
The deposit-sweep ruleAddresses that sweep funds into an exchange’s verified wallets, scored against OKX’s signed lists of its own deposit addresses
Official sourcesBridges’ and privacy protocols’ published addresses and on-chain configs, and the OFAC SDN list

When several sources name the same address, one claim wins the label and the others agree or disagree with it. Disagreement makes the label predicted and fills conflicts.

Tiers

TierMeaning
verifiedThe winning source names the address, the on-chain account check confirms what that source says (a plain wallet for an exchange wallet, a program for a program address, the expected token account for a derived account), and no other source on the address disagrees
predictedThe label rests on Conyr’s observations or on the deposit-sweep rule, the account check does not confirm the source, or sources on the address disagree

An account that changes state (a wallet emptied, or funded again) can move a label between the two tiers at the next registry load; the history keeps both periods.

The reason line

reason is one line: the tier, the primary source in words, the account state at the slot it was checked, then the sources that agree or disagree.

verified: Conyr's curated list, plain wallet at slot 460080146; Conyr's roots list and Binance proof of reserves agree
predicted: Binance deposit address, swept into its verified wallet 5tzFkiKs… (deposit-sweep rule, method card 1), plain wallet at slot 460080131
verified: on the OFAC SDN list as SOKOLOVSKI, Rolan (individual; entry 56360, program ILLICIT-DRUGS-EO14059, list of 2026-10-15), plain wallet at slot 460080137

The sources in words:

SourceIn the reason
Conyr’s curated listConyr's curated list
Conyr’s roots listConyr's roots list
Conyr’s code listsConyr's list of DEX programs, Conyr's list of aggregator programs, Conyr's list of trading-bot programs, Conyr's list of shared pool authorities, Conyr's list of tip accounts, tip accounts published in integrators' code, Axiom's fee addresses from its own code, Conyr's list of <Terminal> fee wallets, Conyr's list of terminal co-signers
Exchanges’ own listsOKX proof of reserves (<release date>), Binance proof of reserves, Bybit proof of reserves, Backpack wallet list, Bitfinex wallet list, Bitstamp wallet list
The deposit-sweep rule<Exchange> deposit address, swept into its verified wallet <first 8>… (deposit-sweep rule, method card <N>); after another source, the deposit-sweep rule agrees
Official sourcespublished by <Name>, <Name> account from its published seeds, named in <Name>'s on-chain config, owner of an account <Name> lists
OFACon the OFAC SDN list as <name> (<individual or entity>; entry <N>, program <P>, list of <date>); after another source, on the OFAC SDN list as <name> (entry <N>)
Conyr’s reviewpublished by <Name>, named in an official record, <Name> account, proven on chain, the operator, with evidence

label.source.url is the first public document among the label’s claims: the winning claim’s first, then the other live claims that name the same service, in the registry’s source order. Public documents are an exchange list’s or an official source’s document URL, OFAC’s list, and the publisher’s file of the published tip list (https links only). Conyr’s own lists and the deposit-sweep rule have no link, so a label they win can still link to an exchange’s list that agrees: Binance’s hot wallet below is won by Conyr’s curated list and links to Binance’s proof of reserves. url is null when no claim has a public document.

GET /v1/address/{address}/label

Returns the address’s current money label with its receipts, what it rests on, conflicting claims, its history and, for a rule’s label, its method card.

Parameters

ParameterInTypeRequiredConstraints
addresspathstringyes32–44 characters from the Solana base58 alphabet; route-level syntax check

Example

curl -sS \
  -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/address/$ADDRESS/label"

Response: an exchange’s hot wallet

Binance’s hot wallet, with receipts shortened to one (the full response holds one per claim: Conyr’s curated list, Conyr’s roots list and Binance’s proof of reserves):

{
  "address": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
  "chain": "solana",
  "label": {
    "entity": {
      "id": "org:binance",
      "name": "Binance",
      "type": "exchange"
    },
    "role": "Hot Wallet",
    "tier": "verified",
    "reason": "verified: Conyr's curated list, plain wallet at slot 460080146; Conyr's roots list and Binance proof of reserves agree",
    "conflict": false,
    "source": {
      "code": "wallet_entity_labels:cex_hot_wallet",
      "url": "https://www.binance.com/bapi/apex/v1/public/apex/market/por/address"
    },
    "sanction": null,
    "confidence": null,
    "since": "2026-10-22T15:07:23.176521Z"
  },
  "receipts": {
    "2830": {
      "claim_id": 2830,
      "document": {
        "copy_sha256": "fbb14f13155027407fb70f96debf7f63a0526c2af56fc5d833f0999eb10ed284",
        "fetched_at": "2026-10-15T22:26:52Z",
        "url": "https://www.binance.com/bapi/apex/v1/public/apex/market/por/address"
      },
      "first_check": {
        "checked_at": "2026-10-22T15:07:23Z",
        "slot": 460080146,
        "state": "plain_wallet"
      },
      "list": "Binance proof of reserves",
      "release": null,
      "role_words": null,
      "run": {
        "id": 1,
        "started_at": "2026-10-22T15:07:23.176521Z"
      },
      "source": "exchange_official"
    }
  },
  "rests_on": [],
  "conflicts": [],
  "method_card": null,
  "history": [
    {
      "entity": {
        "id": "org:binance",
        "name": "Binance",
        "type": "exchange"
      },
      "reason": "verified: exchange list, plain wallet at slot 460080146; the roots file and Binance proof of reserves agree",
      "reworded": true,
      "role": "Hot Wallet",
      "tier": "verified",
      "valid_from": "2026-10-22T15:07:23.176521Z",
      "valid_to": "2026-10-22T15:24:00.262153Z"
    }
  ],
  "identity": null
}

The history row is the same label in the registry’s earlier wording, so reworded is true and since reaches back to it.

Response: a deposit address

A Binance deposit address, with the sweep samples shortened to one. Its receipts also hold the claim it rests on (Binance’s hot wallet, claim 1525), shown above:

{
  "address": "3ADzk5YDP9sgorvPSs9YPxigJiSqhgddpwHwwPwmEFib",
  "chain": "solana",
  "label": {
    "entity": {
      "id": "org:binance",
      "name": "Binance",
      "type": "exchange"
    },
    "role": "Deposit",
    "tier": "predicted",
    "reason": "predicted: Binance deposit address, swept into its verified wallet 5tzFkiKs… (deposit-sweep rule, method card 1), plain wallet at slot 460080131",
    "conflict": false,
    "source": {
      "code": "deposit_sweeps:deposit_sweep_rule",
      "url": null
    },
    "sanction": null,
    "confidence": "1.000",
    "since": "2026-10-22T15:07:23.176521Z"
  },
  "receipts": {
    "25666": {
      "claim_id": 25666,
      "exchange": "Binance",
      "first_check": {
        "checked_at": "2026-10-22T15:07:23Z",
        "slot": 460080131,
        "state": "plain_wallet"
      },
      "list": "the deposit-sweep rule",
      "method_card": 1,
      "paid": [
        {
          "address": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
          "usd": "7354148473.411396"
        }
      ],
      "run": {
        "id": 1,
        "started_at": "2026-10-22T15:07:23.176521Z"
      },
      "snapshot": "20261017T071318Z",
      "source": "deposit_sweeps",
      "sweeps": {
        "assets": [
          "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
          "SOL",
          "USD1ttGY1N17NEEHLmELoaybftRBUSErhqYiQzvEmuB"
        ],
        "first_at": "2026-09-30 00:02:48.215",
        "last_at": "2026-10-17 06:22:59.890",
        "rows": 1912,
        "samples": [
          "16k2ZQfwcLLKZA4ABb28Mvn1ngYhuGBXeo2vf8XFnidKowMA9oC3GXo68LU9Eqrd56xRFKWz2AAucbAFqmYT4ct"
        ],
        "signatures": 1912,
        "usd": "7354148473.411396"
      },
      "window": {
        "from": "2026-09-30 00:00:00",
        "to": "2026-10-17 07:00:00"
      }
    }
  },
  "rests_on": [
    {
      "address": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
      "claim_id": 1525,
      "entity": {
        "id": "org:binance",
        "name": "Binance",
        "type": "exchange"
      },
      "reason": "verified: Conyr's curated list, plain wallet at slot 460080146; Conyr's roots list and Binance proof of reserves agree",
      "role": "Hot Wallet",
      "tier": "verified"
    }
  ],
  "conflicts": [],
  "method_card": {
    "card_id": 1,
    "confidence": "1.000",
    "confidence_is": "the card's lower bound on precision, rounded down and capped at 1",
    "measured_on": "2026-10-17",
    "precision": "above 99.9%",
    "recall": {
      "found": 3577,
      "share": "99.4%",
      "total": 3597
    },
    "rule": "deposit sweeps",
    "scored_on": "OKX's signed lists of its own deposit addresses",
    "window": {
      "from": "2026-09-30T00:00:00.000000Z",
      "to": "2026-10-17T07:00:00.000000Z"
    }
  },
  "history": [
    {
      "entity": {
        "id": "org:binance",
        "name": "Binance",
        "type": "exchange"
      },
      "reason": "predicted: Binance deposit, swept into its verified wallet 5tzFkiKs… (method card 1: 1.000, scored on OKX), plain wallet at slot 460080131",
      "reworded": true,
      "role": "Deposit",
      "tier": "predicted",
      "valid_from": "2026-10-22T15:07:23.176521Z",
      "valid_to": "2026-10-22T15:24:00.262153Z"
    }
  ],
  "identity": null
}

Response: an OFAC address

{
  "address": "42RLPACwZPx3vYYmxSueqsogfynBDqXK298EDsNoyoHi",
  "chain": "solana",
  "label": {
    "entity": null,
    "role": "Sanctioned (OFAC SDN)",
    "tier": "verified",
    "reason": "verified: on the OFAC SDN list as SOKOLOVSKI, Rolan (individual; entry 56360, program ILLICIT-DRUGS-EO14059, list of 2026-10-15), plain wallet at slot 460080137",
    "conflict": false,
    "source": {
      "code": "official_sources:ofac_sdn",
      "url": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"
    },
    "sanction": {
      "entry": 56360,
      "list": "OFAC SDN",
      "list_date": "2026-10-15",
      "name": "SOKOLOVSKI, Rolan",
      "programs": [
        "ILLICIT-DRUGS-EO14059"
      ],
      "type": "individual"
    },
    "confidence": null,
    "since": "2026-10-22T15:07:23.176521Z"
  },
  "receipts": {
    "17895": {
      "claim_id": 17895,
      "documents": [
        {
          "at": "sdnEntry 56360 id 194579",
          "copy_sha256": "5d1d98a80db5790ebba11eccaad0c597826bf54e52327c61258a364cd774f715",
          "fetched_at": "2026-10-18T04:46:51Z",
          "url": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XML"
        }
      ],
      "first_check": {
        "checked_at": "2026-10-22T15:07:23Z",
        "slot": 460080137,
        "state": "plain_wallet"
      },
      "list": "the OFAC SDN list",
      "ofac": {
        "entry": 56360,
        "list_date": "2026-10-15",
        "name": "SOKOLOVSKI, Rolan",
        "programs": [
          "ILLICIT-DRUGS-EO14059"
        ],
        "publication": 1054,
        "type": "individual"
      },
      "role_words": "Digital Currency Address - SOL",
      "run": {
        "id": 1,
        "started_at": "2026-10-22T15:07:23.176521Z"
      },
      "source": "official_sources"
    }
  },
  "rests_on": [],
  "conflicts": [],
  "method_card": null,
  "history": [],
  "identity": null
}

Fields

FieldTypeMeaning
addressstringThe address as sent
chain"solana"Money labels are Solana only
labelobject or nullThe current money label, or the OFAC mark when a person or a handle wins an address on the list; null for a person, a handle only, or no label
label.entity{id, name, type} or nullThe service; type is exchange, custodian, onramp, protocol, bridge, mev, terminal, infrastructure or company; null for the OFAC mark (alone, or when a person or a handle wins)
label.rolestringWhat the address is to the service, such as Hot Wallet, Deposit, Escrow (USDC) or Tip Account; Sanctioned (OFAC SDN) for the mark
label.tier"verified" | "predicted"See Tiers
label.reasonstringSee The reason line
label.conflictbooleantrue when sources on the address disagree; such a label is predicted
label.source{code, url}code is the winning claim’s source and its kind, such as wallet_entity_labels:cex_hot_wallet, exchange_official:okx_por, deposit_sweeps:deposit_sweep_rule or official_sources:ofac_sdn; url per The source link
label.sanctionobject or null{list: "OFAC SDN", entry, name, type, programs, list_date} when the address is on the list; name and type as OFAC writes them
label.confidencestring or nullA rule’s label only: its method card’s lower bound on precision, rounded down and capped at 1, such as "1.000"
label.sinceISO 8601 datetimeWhen the address took this name, role and tier; a rewording does not reset it
receiptsobjectOne receipt per money claim on the label and per claim in rests_on, keyed by claim_id as a string
rests_onarrayFor a rule’s label, the claims it rests on, each with its address and that address’s current label (address, entity, role, tier, reason, claim_id); empty otherwise. An address on an exchange’s own list rests on that list, so its rests_on is empty
conflictsarrayThe other live claims on the address when sources disagree: claim_id, source (in words), entity, role
method_cardobject or nullFor a rule’s label, the rule’s measured card (below)
historyarrayThe address’s earlier money labels, newest first: valid_from, valid_to, entity, role, tier, reason as stated then, and reworded (true when the next newer period has the same service, role and tier, so the row differs only in wording or account state)
identitystring or nullThe /v1/wallet/{address}/identity path when the address’s label has an identity view (a person or a handle)

Receipts

Each receipt is built field by field from what the registry stored. Every receipt has the claim’s source, its claim_id, the registry run that first wrote it (id, started_at), the account check made then (first_check: state, slot, checked_at) and list, the source in words. By source it adds:

SourceFields
exchange_official (an exchange’s own list)release (OKX’s release; null for the other lists), document (url, fetched_at, copy_sha256), role_words (the role words on the address’s line); for OKX, okx (message, the address’s signatures with their file lines, signature_verified); for a Binance custodian line, custodian
deposit_sweeps (the rule)exchange, sweeps (usd, rows, signatures, assets, first_at, last_at, sample signatures in samples), paid (the verified wallets it paid, with the USD to each), window (from, to), snapshot, method_card (the card’s id)
official_sourcesdocuments (each url, fetched_at, copy_sha256, and at, the line or field read; a rpc: url names an on-chain read, not a public document), role_words; for a derived account, derivation ({kind: "pda", program, seeds, bump} or {kind: "ata", owner, mint, token_program}, so anyone can derive it again); for an on-chain config read, config (account, field, slot); for OFAC, ofac (entry, name, type, programs, publication, list_date)
wallet_entity_labels (Conyr’s curated list)added, changed, row_sha256
provenance_roots (Conyr’s roots list)root_label
code_constants (Conyr’s code lists)for the published tip list, section (the provider), publisher_url, publisher_sha256; for an observed list, observed: "seen in transactions Conyr parsed"
operator (Conyr’s review)evidence (kind, url, copy_sha256, captured_at)

The saved copy of each source document stays with Conyr; a copy_sha256 lets anyone holding a copy verify it. A receipt never holds a path on Conyr’s machines, a database host, a curator’s name or an internal note; never an SDN entry’s aliases, documents, dates or contacts; and never the deposit-sweep rule’s recipe (its thresholds, its window rule or its exchange checks).

Method card

A label the deposit-sweep rule won carries the rule’s method card:

FieldMeaning
rule, card_id"deposit sweeps" and the card’s id
scored_onWhat the rule was measured against: OKX’s signed lists of its own deposit addresses
window, measured_onThe observation window and the date the card was measured
recallfound of total listed deposit addresses the rule finds, and the share as a percent rounded down
precisionThe lower bound on precision in words: "above 99.9%" at or above 0.999, else "at least <p>%"
confidence, confidence_isThe label’s confidence and what it is: the card’s lower bound on precision, rounded down and capped at 1

How the precision is computed, and any count or threshold the rule uses, are never shown.

Empty state and people

An address with no money label answers 200:

{
  "address": "Vote111111111111111111111111111111111111111",
  "chain": "solana",
  "label": null,
  "receipts": {},
  "rests_on": [],
  "conflicts": [],
  "method_card": null,
  "history": [],
  "identity": null
}

An address whose label names a person answers the same shape with identity set to "/v1/wallet/{address}/identity", and label null unless the address is on the SDN list, when it is the mark. Read that route for the person, their aliases and their receipts.

Status and freshness semantics

StatusMeaning
200A label, the empty state, or a person pointer, depending on the body
400Not a base58-form Solana address: {"error": "Invalid address", "code": 400}
401Missing or invalid API key
403API key does not include Layer 2
429Per-key request limit exceeded; back off before retrying
500Label registry or service failure
503Authentication or another required backend is temporarily unavailable

The route queries the registry’s Postgres tables at request time and is not response-cached. The registry changes only when Conyr reloads it from its sources, so the route shows it as of its last load.

The short label on other routes

Other routes carry a short label, {name, type, role, tier, reason}, without receipts, or null when the address has no money label. Except on the holders routes, it comes from the registry’s ClickHouse mirror, a dictionary that follows a registry load within 5–10 minutes, and then each route’s own cache. The holders routes read it with the holders from Postgres.

RouteField
GET /v1/wallet/{addr}/labelsaddress_label, the wallet’s own
GET /v1/wallet/{addr}/provenanceroot_address_label, direct_funder_address_label
GET /v1/token/{mint}/funding-abuseeach wallet’s root_address_label, direct_funder_address_label
GET /v1/token/{mint}/holders, /holders/topeach holder’s addressLabel
MCP query_wallet_provenancerootAddressLabel, directFunderAddressLabel
MCP fetch_wallet_labels_batchaddress_labels, every requested address
MCP query_address_labelthis route’s body

See Public KOL Identity for people and handles, and Wallet Intelligence for provenance and behavioral labels.