Skip to main content

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.TypeMeaningLabel.Value
issuer-blocked-usdtFrozen by Tetherbanned-by-usdt
issuer-blocked-usdcFrozen by Circlebanned-by-usdc

How to get it​

Query the Metadata.Labels cube of the Address Labels API. A startsWith filter checks both issuers at once:

Run in Bitquery IDE

{
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​

FieldMeaning
AddressThe address you queried
ChainChain where the freeze applies, for example tron or ethereum
Label.Typeissuer-blocked-usdt or issuer-blocked-usdc
Label.Valuebanned-by-usdt or banned-by-usdc
RecordedAtWhen 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​

Run in Bitquery IDE

{
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.
  • RecordedAt is 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.

Build with Bitquery

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.