Fund flow graph

Get a bounded graph of the transfers into and out of an address, optionally for one token, for investigations and source-of-funds review.

POSThttps://triport.io/v1/intelligence/fund-flow

Network: Ethereum
Scope: intelligence:read
Auth: x-token: $TRIPORT_API_KEY header (or Authorization: Bearer)
Rate limit: Business — 30 rps (intelligence, burst ×2); Enterprise — 150 rps

Request

cURLJavaScriptPython

curl -X POST "https://triport.io/v1/intelligence/fund-flow" \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"eth","address":"0x28c6c06298d514db089934071355e5743bf21d60","token":"0x6b175474e89094c44da98b954eedeac495271d0f"}'

const res = await fetch("https://triport.io/v1/intelligence/fund-flow", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "chain": "eth",
    "address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "token": "0x6b175474e89094c44da98b954eedeac495271d0f"
  }),
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.post(
    "https://triport.io/v1/intelligence/fund-flow",
    headers={
        "x-token": os.environ["TRIPORT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "chain": "eth",
        "address": "0x28c6c06298d514db089934071355e5743bf21d60",
        "token": "0x6b175474e89094c44da98b954eedeac495271d0f",
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "state": "ok",
  "meta": {
    "observedAt": "2026-11-06T09:49:39.995238143Z",
    "expiresAt": "2026-11-06T09:59:39.995238143Z",
    "cached": false,
    "complete": false
  },
  "data": {
    "graph": {
      "nodes": [
        {
          "id": "eth-0x28c6c06298d514db089934071355e5743bf21d60",
          "chain": "eth",
          "address": "0x28c6c06298d514db089934071355e5743bf21d60",
          "label": "Binance: hot wallet (0x28c6)",
          "riskLabels": [
            "EXCHANGE"
          ],
          "isContract": false,
          "isPruned": false
        },
        {
          "id": "eth-0xf977814e90da44bfa03b6295a0616a897441acec",
          "chain": "eth",
          "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
          "label": "Binance: hot wallet (0xf977)",
          "riskLabels": [
            "EXCHANGE"
          ],
          "isContract": false,
          "isPruned": false
        }
      ],
      "edges": [
        {
          "from": "eth-0x28c6c06298d514db089934071355e5743bf21d60",
          "to": "eth-0xf977814e90da44bfa03b6295a0616a897441acec",
          "token": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "tokenLabel": "DAI",
          "amount": "28,116.421",
          "ts": "2026-10-30 00:28:47",
          "isCreate": false,
          "suspiciousFake": false,
          "detail": [
            {
              "hash": "0x9a332492e627e6ec974f59c763e231ab9c614d523bd0a31fc1c83041936630b4",
              "date": "2026-10-30 00:28:47",
              "from": "0x28c6c06298d514db089934071355e5743bf21d60",
              "to": "0xf977814e90da44bfa03b6295a0616a897441acec",
              "amount": "28,116.421"
            }
          ]
        }
      ]
    },
    "coverage": {
      "historyComplete": false,
      "truncationKnown": false,
      "truncated": false,
      "timestampTimezone": "unspecified_by_provider"
    }
  }
}

Get a bounded graph of the transfers into and out of an address, optionally for one token, for investigations and source-of-funds review.

The graph is bounded and can be incomplete; read coverage (historyComplete, truncated). An empty graph is not proof that no transfers happened. Amounts and timestamps are strings as returned; parse them yourself. An uncached graph for a busy address can take tens of seconds, so set a client timeout of at least 60 seconds; repeat calls within a few minutes are served from cache.

Released on Ethereum. Any other chain value answers 422 with state unsupported. More chains are coming; see the changelog.

Every answer is an envelope with state, meta, optional data and optional error. Read state first: ok, empty, partial, stale, unsupported or unavailable (see response states). meta.cached tells you whether the answer came from cache.

Parameters

addressstringrequired

Address to look up: 0x + 40 hex characters, any letter case.

chainstringrequired

Chain id, see Network above (eth, and for labels also solana and avalanche). Aliases: ethereum → eth, sol → solana, avax → avalanche.

freshbooleanoptional

Optional. true skips the cache and asks for a new lookup (GET routes: ?fresh=1).

tokenstringoptional

Optional token contract: restrict the graph to transfers of this token.

Response

Response recorded on 2026-11-06 through https://triport.io (long lists shortened). Values change over time.

Errors

HTTP	`error.code`	When
400	`invalid_request`	Malformed address, unknown field, `null` value or invalid JSON.
401	`unauthorized`	Missing or invalid API key.
403	`scope_missing` / `tier_insufficient`	The key lacks `intelligence:read`, or the plan is below Business.
405	`method_not_allowed`	Wrong HTTP method; the `Allow` header names `POST`.
422	`unsupported`	The chain (or the contract) is not supported by this method.
429	`rate_limited`	Over the `intelligence` per-second limit; wait `Retry-After` seconds.
503	`unavailable`	The lookup could not be completed right now; retry later.
504	`timeout`	The lookup took too long; retry, or retry later with the same input.

See errors, limits and states for the full rules and the code examples.