wallets

Wallet flow graph

Free render-ready transaction-flow graph for a Bitcoin wallet address. Default min_btc=0.1 is a value-flow display filter; response filters report omitted edge candidates, and min_btc=0 is the honest attribution/ownership view. Large or cold wallets use bounded history and edge-candidate sampling; partial/truncated responses report the active caps, and slow cold builds return structured JSON 503 with Retry-After.

get/v1/wallets/{address}/flow-graph

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}/flow-graph
  • Auth: none declared

Path parameters

addressstring required

Query parameters

hopsinteger
direction'in' | 'out' | 'both'
min_btcnumber

Minimum BTC value for an edge candidate to appear. Default 0.1 BTC is a value-flow display filter; the response filters include edge_candidates_filtered_by_min_btc. Use min_btc=0 for ownership or attribution analysis; large cold wallets may return partial=true or a structured retry-503 while the cache warms.

sincestring nullable

Only include transactions at or after this ISO timestamp.

include_labelsboolean
node_limitinteger
viewstring nullable

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

Response

Wallet flow graph

kind'wallet_flow_graph'
rootstring required
depthinteger required
nodesobject[]
edgesobject[]
node_countinteger required
edge_countinteger required
filtersobject
truncatedboolean required
partialboolean required
betaboolean required

Changes

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