BLblockaid-official
Label Management

Apply Label to Address

Changed on

Apply a label to an address. Pass a single chain to scope to one chain, or omit chain (or send null) to apply the label across ALL chains the identifier belongs to (sticky — the label auto-applies to any new chains the identifier is detected on in the future). Labels are unique per (identifier, chain, label); re-applying the same label on the same chain returns 409.

post/v0/platform/labels/addresses/{address}

Request

Path parameters

addressstring required

The contract or wallet address to label. Addresses are matched by format: 0x-prefixed hex addresses (EVM, Sui, and similar) are matched case-insensitively — lowercase, EIP-55 checksummed, and all-uppercase forms all resolve to the same entity (the checksum is not validated); other formats (e.g. base58 Solana addresses) are matched verbatim.

Request body

labelstring required

The label to apply, by name (e.g. "Phishing"). Matched case-insensitively against the label catalog (GET /v0/platform/labels/types). Labels are unique per (identifier, chain, label) — re-applying on the same chain returns 409; an identifier may carry multiple distinct labels.

chainstring nullable

Single chain to apply the label to (e.g. "ethereum"). Omit or send null to apply the label across ALL chains the identifier belongs to (sticky — includes chains added in the future). An unsupported chain returns 422 with the supported-chains list.

tagsstring[]

Optional tags to group labels by.

commentstring nullable

Optional free-text note explaining the label.

Response

Label applied

idstring uuid required

Unique ID of this label assignment.

identifierstring required

The labeled address, domain or token.

identifier_type'address' | 'domain' | 'token' required

The type of the labeled identifier.

chainstring nullable required

The chain this label applies to. null means the label applies to ALL chains (sticky); chain is always null for domains, which are not chain-scoped.

labelstring required

The applied label name.

result_type'Malicious' | 'Benign' required

Whether this label marks the entity as Malicious (block) or Benign (allow). Derived from the label.

tagsstring[] required

Tags grouping this label.

commentstring nullable

Free-text note explaining the label, if any.

created_bystring required

Who created the assignment (e.g. "API" or a user identifier).

updated_bystring required

Who last updated the assignment.

created_atstring date-time required

Creation timestamp (ISO 8601, UTC).

updated_atstring date-time required

Last-update timestamp (ISO 8601, UTC).

Changes