Saltar al contingut principal
POST
curl

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json
wallet_address
string
requerit

L'adreça de criptomoneda o l'identificador de xarxa que cal analitzar. Ha de coincidir amb la xarxa seleccionada (p. ex., una adreça de 40 caràcters hexadecimals amb el prefix 0x per a cadenes EVM). Àlies: address.

Exemple:

"0x94f1b9b64e2932f6a2db338f616844400cd58e8a"

blockchain
enum<string>

Identificador de xarxa opcional. Si s'omet, la xarxa es llegeix a partir del format de l'adreça: les adreces bc1, 1 i 3 són Bitcoin (BTC), les adreces T són Tron (TRX) i les claus públiques base58 són Solana (SOL). Una adreça 0x és vàlida a totes les xarxes EVM, de manera que ometre blockchain per a aquesta respon 422 amb les xarxes candidates a candidate_chains. El cribratge gestionat admet BTC, ETH, LTC, XRP, BCH, DOGE, TRX, SOL, MATIC, BNB, BASE (Base), OP (Optimism), ARB (Arbitrum One), AVAX (Avalanche C-Chain), ADA (Cardano), XLM (Stellar) i HBAR (Hedera). USDT i USDC són àlies heretats d'Ethereum, no cerques multixarxa. La cobertura de proveïdors connectats varia. LIGHTNING requereix un proveïdor connectat compatible. CELO (Celo), MODE (Mode) i PLUME (Plume) es cribren mitjançant un compte connectat de TRM Labs; el cribratge gestionat respon 400 per a aquests. Àlies: currency.

Opcions disponibles:
BTC,
LIGHTNING,
ETH,
LTC,
XRP,
BCH,
DOGE,
TRX,
SOL,
MATIC,
BNB,
USDT,
USDC,
BASE,
OP,
ARB,
AVAX,
ADA,
XLM,
HBAR,
CELO,
MODE,
PLUME
Exemple:

"ETH"

direction
enum<string>

Opcional. Indica si l'adreça s'està cribrant com a contrapart entrant (dipòsit) o sortint (retirada). Accepta inbound, outbound, deposit o withdrawal. Per defecte aplica un cribratge neutre previ a la transferència si s'omet. Això només es passa al proveïdor com a context; no canvia el risk_score, la severity ni el desglossament de source_of_funds/destination_of_funds retornats, que es retornen sempre tots dos independentment de direction. Per tant, canviar o ometre direction no requereix tornar a cribrar una adreça.

Opcions disponibles:
inbound,
outbound,
deposit,
withdrawal

Resposta

El resultat normalitzat del cribratge de carteres.

provider
string
requerit

Proveïdor que ha dut a terme el cribratge (p. ex. merklescience, crystal).

screening_type
enum<string>
requerit

Sempre WALLET_SCREENING per a aquest endpoint.

Opcions disponibles:
WALLET_SCREENING
risk_score
integer
requerit

Puntuació de risc normalitzada de 0 a 100. Un valor més alt indica una exposició més gran a entitats de risc. Merkle Science qualifica una adreça de 0 a 5, la qual cosa es correspon amb 0, 15, 35, 55, 75 o 95.

severity
enum<string>
requerit

Grup de risc derivat de risk_score: 0-9 UNKNOWN, 10-39 LOW, 40-69 MEDIUM, 70-89 HIGH, 90-100 CRITICAL. UNKNOWN és la franja més baixa, no un estat independent sense dades: un risk_score de 0 (el cas habitual d'una adreça neta) significa sense avaluació adversa, mentre que una puntuació diferent de zero en l'interval 1-9 és un senyal real però inferior a LOW; llegeix el risk_score, no només la franja. No tractis mai UNKNOWN com una qualificació afirmativa de risc baix o neta; no la mostris com un aprovat.

Opcions disponibles:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
status
enum<string>
requerit

Estat del resultat del cribratge.

Opcions disponibles:
SCREENED,
PENDING,
ERROR
summary
string
requerit

Resum del resultat del cribratge, llegible per a humans.

wallet_address
string
requerit

L'adreça analitzada, que es retorna tal qual.

blockchain
string
requerit

La blockchain que s'ha analitzat.

source_of_funds
object[]
requerit

D'on ha rebut fons l'adreça, atribuït per entitat. Cada entrada és un desglossament de l'exposició.

destination_of_funds
object[]
requerit

Cap a on ha enviat fons l'adreça, atribuït per entitat. Té la mateixa estructura d'element que source_of_funds amb exposure_direction = outgoing.

counterparty_connections
object[]
requerit

Entitats a les quals el proveïdor atribueix l'adreça analitzada. En el cas de Merkle Science, provenen de les etiquetes de propietari i d'usuari de la mateixa adreça, de manera que la mateixa entitat pot aparèixer dues vegades, i no comporten fluxos de fons: received_usd, sent_usd, received_hops i sent_hops són null i percentage és 0. No facis encaminament segons risk_level o is_direct aquí: fes servir sanctions_hit, dominant_risk_category i risk_factors[].is_high_risk per al veredicte, i exposure_type a source_of_funds/destination_of_funds per determinar si són directes.

sanctions_hit
boolean
requerit

Cert si l'adreça té exposició directa o indirecta a sancions.

dominant_risk_category
string | null
requerit

Categoria d'alt risc amb més pes, o null quan cap no és dominant (p. ex. sanctioned, mixer, stolen_funds).

report_signature
string
requerit

Signatura HMAC-SHA256 opaca sobre aquest resultat exacte, delimitada a la teva aplicació. No té sentit per si sola: torna a enviar el cos complet de la resposta, sense modificar i incloent aquest camp, a POST /v3/wallet-screening/pdf/ per renderitzar-lo com a PDF. L'endpoint de PDF rebutja la sol·licitud amb 400 si falta report_signature o si s'ha editat algun camp signat (p. ex., risk_score, severity, sanctions_hit) abans de tornar-lo a enviar.

transaction_hash
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

block_timestamp
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

total_value_usd
number | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

fee_usd
number | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

sender_rows
object[]

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre està buit en un resultat de cribratge de carteres.

receiver_rows
object[]

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre està buit en un resultat de cribratge de carteres.

transaction_flows
object[]

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre està buit en un resultat de cribratge de carteres.

transaction_flows_status
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

transaction_flows_error
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

network_nodes
object[]

Nodes del graf d'exposició per al cribratge de transaccions. Buit en un resultat de cribratge de carteres.

network_edges
object[]

Arestes del graf d'exposició per al cribratge de transaccions. Buit en un resultat de cribratge de carteres.

pep_counterparty
boolean | null

Exposició com a persona políticament exposada. null quan no hi ha cap detecció de PEP disponible, que és el cas de tots els resultats actualment perquè cap proveïdor n'informa; false només per a un resultat de cribratge explícitament negatiu. No interpretis null com una comprovació de PEP completada.

risk_factors
object[]

Explicació classificada de risk_score: què ha produït aquest veredicte. Els proveïdors avaluen una adreça segons el seu propi model i només retornen un veredicte (Merkle Science retorna un enter del 0 al 5), de manera que la puntuació per si sola no permet prendre decisions. S'ordena primer per risc alt i després pel valor que ha passat per cada factor determinant, limitat als cinc més rellevants; source_of_funds i destination_of_funds sempre inclouen el desglossament complet. Un risk_score alt sense cap entrada is_high_risk significa que el proveïdor no ha detectat coincidències amb sancions ni entitats atribuïdes i ha avaluat l'adreça purament segons el seu propi model d'exposició; summary ho indica explícitament.

raw_response
object

El payload propi del proveïdor. La seva estructura és específica del proveïdor i pot canviar sense previ avís: llegeix els camps normalitzats en lloc d'analitzar-lo directament.

Darrera modificació el 7 de novembre del 2026