Skip to main content
Address Registry maps blockchain addresses in the Fireblocks network to the legal entities that control them. It is free, on by default for every workspace, and works on consent: while your workspace participates, other participating customers can look up your addresses and you can look up theirs. Results come from registered data, not transaction heuristics. To appear as a verified entity, register your LEI in Legal Entity Setup; to accept or reject transactions based on the counterparty, see About Address Registry Screening.

​
What you can do through the API

​
Look up an address

Call the lookup endpoint. URL-encode the address when needed. You can look up any address: there’s no requirement to have an active or pending transaction with it. Only workspaces that participate in Address Registry can query it.
There’s no separate field for “verified” — leiData is that signal. Anything else is based on Fireblocks data without that independent check. A lookup returns information about the legal entity only: its name, jurisdiction, and LEI if declared. It never returns anything about that entity’s own customers or account holders, and the registry holds no link between vault addresses and identified individuals. The lookup returns not_found when the counterparty isn’t a Fireblocks customer, has opted out, or is on an unsupported environment. A not_found result doesn’t mean the address is unhosted, illicit, or non-compliant. You can only look up a specific address: you can’t enumerate the registry or query in reverse. To prevent bulk data extraction, lookups are also authenticated, rate limited, capped daily, and monitored, so the number of queries stays proportional to your transactions. See Acceptable use.

​
Manage participation

You can opt out your whole workspace, or only specific vault accounts, at any time, and opt back in later. Opting out has three effects:
  • Lookups against your opted-out addresses return not_found.
  • A workspace that has opted out can’t look up addresses itself.
  • Compliance workflows built on Address Registry, including About Address Registry Screening, stop working until you opt back in.
To exclude all current and future workspaces in your account, contact your Customer Success Manager.

​
Limitations

  • European and Swiss-hosted workspaces aren’t supported. Lookups against addresses from these workspaces return not_found.
  • Developer Sandbox workspaces don’t support Address Registry.
  • Coverage is limited to addresses within the Fireblocks network.

​
Acceptable use

Address Registry exists only to verify counterparties in connection with digital asset transactions. You must not:
  • Use it for any other purpose.
  • Scrape, bulk-download, or systematically extract data from it.
  • Resell, redistribute, or commercialize query results, or any data obtained from it.
  • Attempt to identify, profile, or de-anonymize individual people using its data.
  • Use it for surveillance or competitive intelligence.
  • Circumvent technical controls, authentication requirements, or rate limits.
Fireblocks monitors usage for misuse, and can suspend or revoke access, with or without notice, if it detects abuse. Your use must comply with your agreement with Fireblocks. You should also assess your own data protection obligations for participating.

​
On the Help Center

To look up addresses or manage participation in the Console, see About Address Registry.