---
title: "Interface Routing Flows"
method: GET
path: "/api/v1/flows"
tags: ["Core Data"]
---

# Interface Routing Flows

`GET /api/v1/flows`

## Request

- Base URL: `https://cleartracedata.com` (the document declares no server; this is the origin it was published from)
- URL: `https://cleartracedata.com/api/v1/flows`
- Auth: none declared

**Public API: Returns interface-to-interface routing flows.**

Each edge is a `source → target` volume aggregate from the attribution
engine — e.g. how much direct-retail volume flows into a given router or
unknown proxy. Useful for mapping where trade origination concentrates.

## Query parameters

- `source` string: Filter by source interface (substring match).
- `target` string: Filter by target interface (substring match).
- `limit` integer: Maximum number of edges to return.
- `offset` integer: Pagination offset.

## Response `200`

Source→target routing edges showing how volume moves between interfaces and routers.

- RoutingFlowsResponse
  - `flows` RoutingFlow[], required: Interface-to-interface routing edges, largest first.
    - `source` string, required: The originating interface or wallet cohort.
    - `target` string, required: The interface/router the volume flowed into.
    - `volume_usd` number, required: Total USD volume on this source→target edge.
  - `total` integer, required: Total number of matching edges.
  - `limit` integer, required: The maximum number of edges returned.
  - `offset` integer, required: The offset used for pagination.

---

[API](https://skmtc.dev/cleartracedata/apis/cleartrace-api.md) · [All operations](https://skmtc.dev/cleartracedata/apis/cleartrace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cleartracedata/apis/cleartrace-api/revisions/2073a5a38ab5?raw)