Skip to main content
POST
Contribute a private label

Authorizations

X-API-Key
string
header
required

Your API key in the X-API-Key header.

Headers

X-Case-Id
string | null

Optional case the label is added to: the token of a case you can edit. Without this header, the label belongs to your API key. A case that does not exist or that you cannot edit returns 400 and the label is not saved.

Body

application/json
address
string
required
label
string
required
chain
string
default:ethereum
category
string
default:unknown
source
string
default:""
confidence
number
default:0.5
method
string
default:heuristic
added_by
string
default:seed
service_type
enum<string> | null
Available options:
instant-exchanger,
privacy-pool,
deposit-address
conflicting_tags
ConflictingTag · object[]
sanctions_history
SanctionsEvent · object[]
chain_basis
LabelChainBasis · object | null

Por qué una label publicada para OTRA chain (origin_chain = Label.chain) aparece en la chain de la consulta (applied_chain). Lo pone el server al leer el índice (labels.for_chain); ninguna fuente ni cliente lo escribe. Sin este campo, la label es de la misma chain de la consulta (o de usuario, que vale en toda chain). • same_key: la address es una EOA medida (tiene clave), y la clave es la misma en toda chain EVM: la label se aplica acá como INFERENCIA declarada, con su categoría. • designation: la lista OFAC designa la address (y sus bajas la fechan): vale en toda chain EVM. • not_applied: contrato, cuenta sin prueba de clave o sin medir en su origen: en esta chain la misma address puede ser otra cosa, así que la label viaja como context (peso 0) y el nodo toma nombre y categoría de su propia chain.

entity
EntityRef · object | null

La entidad regional a la que pertenece la MARCA de una label (ver el bloque de arriba).

observed_at
string | null
observed_basis
enum<string> | null
Available options:
source_row,
source_snapshot,
source_commit,
measured,
analyst,
none
valid_until
string | null
validity
enum<string> | null
Available options:
not_declared,
ended,
live
license
LabelLicense · object | null

La licencia de la FUENTE de una label (registro attribution/provenance.py, por added_by): qué licencia es, si permite el uso comercial y si el dato va en un entregable. None en la label = no consta.

Response

Successful response.