wallets

Wallet trust and safety teaser

Free endpoint returning satoshidata.ai's public trust card for a Bitcoin wallet, including historical_flags and the coarse present-state risk_indicator.

get/v1/wallets/{address}/trust-safety

Request

  • Base URL: https://satoshidata.ai (the document declares no server; this is the origin it was published from)
  • URL: https://satoshidata.ai/v1/wallets/{address}/trust-safety
  • Auth: none declared

Path parameters

addressstring required

Query parameters

viewstring nullable

Optional response view. Set view=compact for a smaller agent-oriented payload.

Response

Wallet trust and safety teaser

kind'trust_safety'
addressstring required
address_typeobject required

Parsed Bitcoin address type and support metadata.

claim_typestring nullable

Runtime claim type when a public claim is asserted.

confidencestring required

Public confidence level for the asserted trust card.

evidence_tierstring required

Evidence tier backing the public trust card.

confidence_tier'verified' | 'attributed' | 'clustered' | 'reported' required

Public provenance authority for verified, attributed, clustered, or reported treatment.

is_verified_identityboolean required

True only when confidence_tier is verified; false for attributed, clustered, imported, or reported leads.

evidence_typesstring[]

Evidence categories behind the public trust card.

sourcestring nullable

Public source family for the asserted label, when available.

source_refstring nullable

Source reference for the asserted label, when available.

narrativestring nullable

Short public narrative when one is available.

updated_atstring nullable

Best-known label update timestamp when available.

caveatsstring[]

Customer-visible caveats and scope notes.

cluster_recencyobject nullable

Present only for held-and-public addresses with cluster recency metadata.

examinedboolean nullable

True when the response includes an examined direct-exposure state; false or omitted for pure address-label lookup results.

examined_source'direct-counterparty-exposure' | 'address-label-corpus' | 'batch-direct-trace-deferred' nullable

Machine-readable source for the examined marker or explicit batch trace deferral.

notestring nullable

Customer-visible scope note for direct exposure, clean-trace, not-assessable, or batch-deferred states.

historical_flagsstring[]

Exact-address public incident/history tags. Empty array when no seeded flag exists.

risk_indicator'unknown' | 'neutral' | 'elevated' nullable

Coarse present-state risk indicator, separate from historical_flags.

betaboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.