Frozen USDT and USDC Address API
Check whether Tether or Circle has frozen an address before you accept stablecoins from it or send to it. Bitquery labels more than 10,000 issuer-frozen addresses on Tron, Ethereum, Solana and BNB Chain.
ProductUsing this in production? See the Address Labels API page for plans, free trial and enterprise delivery options.
What it is
Stablecoin issuers can freeze an address on their own token contract. A frozen address cannot move that stablecoin.
Label.Type | Meaning | Label.Value |
|---|---|---|
issuer-blocked-usdt | Frozen by Tether | banned-by-usdt |
issuer-blocked-usdc | Frozen by Circle | banned-by-usdc |
How to get it
Query the Metadata.Labels cube of the Address Labels API. A startsWith filter checks both issuers at once:
{
Metadata {
Labels(
where: {
Address: {in: [
"TPyANq1XfaL4xLiWDdPnebZxdgFAQLU9ei",
"0x098b716b8aaf21512996dc57eb0615e2383e2f96",
"0x03ffb8cc16499d20cf79261ebc7064f72984330e"
]}
Label: {Type: {startsWith: "issuer-blocked"}}
}
limitBy: {by: [Address, Chain, Label_Type], count: 1}
orderBy: {descending: RecordedAt}
) {
Address
Chain
Label {
Type
Value
}
RecordedAt
}
}
}
Frozen addresses come back with their chain and issuer. Addresses that are not frozen are absent from the response.
How it is derived
Bitquery's labelling pipeline compiles each label from many inputs and returns one finished result: a type, a value and the date it was recorded. Responses carry the label itself, not a per-label source reference.
Fields
| Field | Meaning |
|---|---|
Address | The address you queried |
Chain | Chain where the freeze applies, for example tron or ethereum |
Label.Type | issuer-blocked-usdt or issuer-blocked-usdc |
Label.Value | banned-by-usdt or banned-by-usdc |
RecordedAt | When the label was added to Bitquery's label table. It is not the date of the freeze |
Examples
Check one Tron address for a USDT freeze
{
Metadata {
Labels(
where: {
Address: {is: "TPyANq1XfaL4xLiWDdPnebZxdgFAQLU9ei"}
Label: {Type: {is: "issuer-blocked-usdt"}}
Chain: {is: "tron"}
}
limit: {count: 1}
orderBy: {descending: RecordedAt}
) {
Address
Chain
Label {
Value
}
}
}
}
Screen incoming stablecoin payments
Take the sender addresses of incoming USDT or USDC transfers from the Transfers cube and run them through the first query in batches of 100.
Pitfalls
- A freeze is per chain and per token. An address frozen for USDT on Tron is not automatically frozen on Ethereum. Read
Chain. RecordedAtis not the freeze date. For the on-chain moment, read the issuer contract's events for that address.- Unfreezes happen. Labels are corrected in place, so re-run the lookup for addresses you track.
Get the full dataset
For the complete list of issuer-frozen addresses, buy the Address Labels dataset on the Bitquery Data Store. The Tron USDT transfers dataset carries the transfer history to go with it.
Frequently Asked Questions
How do I check if a USDT address is blacklisted?
Query Metadata.Labels with the address and Label Type set to issuer-blocked-usdt. A returned row means Bitquery holds a Tether freeze label for it on the chain shown in the Chain field.
Does it cover USDC?
Yes. Addresses frozen by Circle carry the type issuer-blocked-usdc. A startsWith filter on issuer-blocked checks both issuers in one query.
Which chains are covered?
Tron and Ethereum hold most frozen addresses. Solana and BNB Chain are covered too.
Related
Ready to run this in production?
Get an API key and run these queries in minutes, or talk to us about plans and enterprise delivery.