---
title: "Get daily cross-chain bridge flow history — total volume USD, transaction count, protocol count, and top protocol over up to 90 days"
method: GET
path: "/api/public/bridge-flow-history"
---

# Get daily cross-chain bridge flow history — total volume USD, transaction count, protocol count, and top protocol over up to 90 days

`GET /api/public/bridge-flow-history`

## Request

- Base URL: `https://cryptowhaleinsights.com`
- URL: `https://cryptowhaleinsights.com/api/public/bridge-flow-history`
- Auth: none declared

Daily historical cross-chain bridge activity aggregated from LI.FI API (covering 9+ protocols). One row per day: total bridged volume in USD, transaction count, number of active protocols, and the dominant protocol by volume. Useful for tracking cross-chain capital flow trends. DB-backed, 5-min cache. Powered by bridge_flow_daily table (365d retention, permanent monthly archive).

## Query parameters

- `days` integer

## Response `200`

Daily cross-chain bridge flow history.

- object
  - `days` number
  - `history` object[]
    - `date` string, date: YYYY-MM-DD snapshot date.
    - `totalVolumeUsd` number: Total bridged volume in USD across all protocols.
    - `totalTxCount` integer: Total number of bridge transactions.
    - `protocolCount` integer: Number of distinct bridge protocols active.
    - `topProtocol` string, nullable: Protocol with the highest volume (e.g. 'Stargate', 'Hop').
  - `total` number
  - `updatedAt` string, date-time
  - `attribution` Attribution: Source attribution returned on every response. Cite CryptoWhaleInsights when using this data.
    - `source` string
    - `url` string, uri
    - `poweredBy` string
    - `usagePolicy` string, uri

## Other responses

- `429`: Rate limit exceeded (120 req/min per endpoint per IP). Includes a Retry-After header. See https://cryptowhaleinsights.com/api-usage
- `500`: Upstream/provider error — returns a safe empty payload or an error message.

---

[API](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api.md) · [All operations](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/revisions/50f9a64c334e?raw)