API Documentation

Exchange an API key for a short-lived bearer token.

Request body (JSON)

Response

{ "token": "<JWT>", "expiresIn": 3600, "plan": "free" }

List vaults with optional filters and pagination.

Query parameters (all optional)

Response

{
  "data": [ { /* Vault */ } ],
  "pagination": { "total": 1342, "limit": 100, "offset": 0, "hasMore": true },
  "availableFilters": { "protocol_names": [...], "chain_ids": {...}, "all_chain_ids": [...] }
}

Fetch a single vault by its pool id. Returns 404 if not found.

Response

{ "data": { /* Vault */ } }

Daily time-series for a vault. Here :id is the strategy id (strategy_id on the Vault object).

Query parameters

Response

{
  "data": [
    { "timestamp": "2026-06-23T00:00:00Z", "tvl": 12500000, "apr": 6.21,
      "apy": 6.40, "ra_apr": 5.11, "tvl_30d_ma": 12100000, "apr_30d_ma": 6.05,
      "apy_30d_ma": 6.18 }
  ],
  "lastTvl": 12500000, "lastApr": 6.21, "lastApy": 6.40, "lastRaApr": 5.11,
  "lastTvl30dMa": 12100000, "lastApr30dMa": 6.05, "lastApy30dMa": 6.18, "lastRaApr30dMa": 4.95
}

ra_apr is risk-adjusted APR: APR minus a penalty derived from the vault's published overall risk score (0–100, higher = safer); it is null when the vault has no published assessment.

Aggregated stats over fixed windows for a vault (:id = strategy id). Omit period to get all windows.

Query parameters

Response

{
  "weekly":  { "tvl_low": 11.8e6, "tvl_high": 12.6e6, "apr": 6.1, "apy": 6.3,
               "inflows": 2.1e5, "period_start": "...", "period_end": "...",
               "cagr": 6.2, "volatility": 1.4, "sharpe": 1.8, "sortino": 2.3 },
  "monthly": { ... }, "quarterly": { ... }, "yearly": { ... },
  "lifetime": { ... }
}

inflows is the net TVL change over the window (last day − first day): positive = net inflow, negative = net outflow. It is TVL-based, so it also reflects yield earned over the window, not just deposits/withdrawals. Each window also includes risk/return metrics — cagr, volatility, sharpe, and sortino — plus a lifetime (all-time) window.

The vault's holder list — :id = strategy id. Each entry is an address with its balance and share of the vault's TVL. (Vault.holders gives just the holder count.)

Response

{
  "data": [
    { "address": "0x1a2b…c3d4", "balance": 12345.6, "share_pct": 4.2 }
  ]
}

Daily history of the DeFi Base Rate — the mean yield across the tracked stablecoin (stable) and ETH (eth) vault sets — plus the 3-month U.S. T-Bill risk-free rate (tbills). No parameters; each series is sorted oldest to newest.

Response

{
  "stable": [ { "timestamp": "2026-06-23T00:00:00Z", "apr": 5.4, "apy": 5.55,
                "apr_30d_ma": 5.2, "apy_30d_ma": 5.34 } ],
  "eth":    [ { "timestamp": "2026-06-23T00:00:00Z", "apr": 3.1, "apy": 3.15,
                "apr_30d_ma": 3.0, "apy_30d_ma": 3.05 } ],
  "tbills": [ { "timestamp": "2026-06-23T00:00:00Z", "rate": 3.79 } ]
}

Hack and loss events — every tracked DeFi exploit plus a reference set of major TradFi banking losses, the dataset behind our DeFi vs TradFi losses analysis. Each event carries its date, the protocol or institution, the amount lost in USD, and — for DeFi — what kind of protocol was hit.

Query parameters (all optional)

Response

{
  "data": [
    { "id": 1937, "date": "2022-03-28T23:00:00+00:00", "name": "Ronin",
      "amount_hacked": 624000000, "category": "defi", "type": "Bridges" }
  ],
  "summary": { "count": 285, "total_amount_hacked": 18824475500,
               "first_date": "2020-09-28T23:00:00+00:00",
               "last_date": "2026-07-10T00:00:00+00:00" },
  "pagination": { "total": 285, "limit": 100, "offset": 0, "hasMore": true }
}

summary covers the entire filtered set, not just the returned page — so total losses for a window can be read without paging through every event.

type is present on DeFi events only, and is one of DeFi (lending, yield, staking, stablecoins), Dexes, or Bridges. TradFi events are bank failures, which the taxonomy does not describe, so they omit the field.

Example — DeFi losses in 2025, biggest first

curl -H "Authorization: Bearer $TOKEN" \
  "https://pigi.finance/api/v1/hacks?category=defi&from=2025-01-01&to=2025-12-31&sort=amount_desc"

Example — total ever lost to bridge exploits

curl -H "Authorization: Bearer $TOKEN" \
  "https://pigi.finance/api/v1/hacks?type=bridges&limit=1"   # read summary.total_amount_hacked

Your request count for the current calendar month (UTC) and your plan limit.

Response

{
  "clientId": 1, "plan": "free",
  "period": { "start": "2026-06-01T00:00:00Z", "end": "2026-07-01T00:00:00Z" },
  "used": 1423, "limit": 100000, "remaining": 98577
}

limit and remaining are null when your plan has no cap.

Discovery index — lists the available endpoints and the docs URL.