---
title: "Trace Flows"
method: POST
path: "/v1/trace/flows"
tags: ["trace"]
---

# Trace Flows

`POST /v1/trace/flows`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/trace/flows`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Bridge-aware multi-hop fund-flow trace from an address.

Mirrors the MCP ``trace_flows`` tool verbatim: per-node sanctions_status /
mixer_flag, per-edge bridge annotation, ``stats`` + ``truncation_reason``.

## Request body

- TraceFlowsRequest
  - `address` string, required
  - `chain` string
  - `case_id` integer, nullable
  - `capture` boolean
  - `direction` 'forward' | 'backward' | 'both'
  - `max_hops` integer
  - `value_threshold_usd` number, nullable
  - `lookback_hours` integer
  - `source` 'graph_edges' | 'deepstore'

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bitpoort/apis/bitpoort-api.md) · [All operations](https://skmtc.dev/bitpoort/apis/bitpoort-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitpoort/apis/bitpoort-api/revisions/1a51d8566777?raw)