FlowFiFlowFi
Enter Terminal
The API

Documentation

Every endpoint, by example.

curl · JavaScript · PythonSDKs: Soon

Each request and the answer it returns, in the shape the API sends. Values are examples.

Architecture
REST over HTTPS. Read-only GET requests, answered from what FlowFi already stored. Nothing is computed or bought for your request.
Authentication
Send your key on every request in the Authorization header: Bearer ffi_…. Keys stay on your server; browser calls from other websites are refused.
Data format
JSON. Every answer has ok: true or false. Errors also carry error (a code) and message. Times are ISO 8601 in UTC, prices in USD.
Usage limits
Each answer carries X-RateLimit-* (per minute) and X-Quota-* (per month) headers and a usage block in the body. Past a limit: 429 with Retry-After.
GET /api/v1/validatedValidated
curl
curl -H "Authorization: Bearer $FLOWFI_KEY" \
  "https://flowfiengine.app/api/v1/validated"
JavaScript
const res = await fetch("https://flowfiengine.app/api/v1/validated", {
  headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://flowfiengine.app/api/v1/validated",
    headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
Response · 200
{
  "ok": true,
  "observedAt": "2026-11-12T15:00:00.000Z",
  "delayedMinutes": 0,
  "count": 1,
  "tokens": [
    {
      "mint": "FFiTest111111111111111111111111111111111111A",
      "symbol": "TEST",
      "name": "FlowFi Test Token",
      "imageUrl": null,
      "stage": "validated",
      "state": "ACTIVE",
      "activity": 72,
      "buyers": 184,
      "priceUsd": 0.000412,
      "marketCapUsd": 412000,
      "liquidityUsd": 58400,
      "volumeH1": 41200,
      "volumeH24": 388000,
      "changeH1": 18.4,
      "buys1h": 512,
      "sells1h": 377,
      "ageMinutes": 95,
      "hasX": true,
      "theme": "meme",
      "firstDetectedAt": "2026-11-12T13:25:00.000Z",
      "firewall": "passed"
    }
  ],
  "themes": [
    {
      "theme": "meme",
      "tokens": 6,
      "volume1h": 210000,
      "volume24h": 1900000,
      "change1h": 9.2,
      "share": 0.41
    }
  ],
  "usage": {
    "plan": "builder",
    "minute": {
      "used": 1,
      "limit": 120,
      "resetsAt": "2026-11-12T15:01:00.000Z"
    },
    "month": {
      "used": 1,
      "limit": 250000,
      "resetsAt": "2026-12-01T00:00:00.000Z"
    }
  },
  "requestId": "req_example"
}
GET /api/v1/early-radarEarly Radar
curl
curl -H "Authorization: Bearer $FLOWFI_KEY" \
  "https://flowfiengine.app/api/v1/early-radar"
JavaScript
const res = await fetch("https://flowfiengine.app/api/v1/early-radar", {
  headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://flowfiengine.app/api/v1/early-radar",
    headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
Response · 200
{
  "ok": true,
  "observedAt": "2026-11-12T15:00:00.000Z",
  "delayedMinutes": 0,
  "count": 1,
  "tokens": [
    {
      "mint": "FFiTest111111111111111111111111111111111111B",
      "symbol": "TEST",
      "name": "FlowFi Test Token",
      "imageUrl": null,
      "stage": "early_radar",
      "state": "EARLY",
      "activity": null,
      "buyers": null,
      "priceUsd": 0.000412,
      "marketCapUsd": 412000,
      "liquidityUsd": 58400,
      "volumeH1": 41200,
      "volumeH24": 388000,
      "changeH1": 18.4,
      "buys1h": 512,
      "sells1h": 377,
      "ageMinutes": 95,
      "hasX": true,
      "theme": "meme",
      "firstDetectedAt": "2026-11-12T13:25:00.000Z",
      "firewall": "passed"
    }
  ],
  "usage": {
    "plan": "builder",
    "minute": {
      "used": 1,
      "limit": 120,
      "resetsAt": "2026-11-12T15:01:00.000Z"
    },
    "month": {
      "used": 1,
      "limit": 250000,
      "resetsAt": "2026-12-01T00:00:00.000Z"
    }
  },
  "requestId": "req_example"
}
GET /api/v1/resultsResults
curl
curl -H "Authorization: Bearer $FLOWFI_KEY" \
  "https://flowfiengine.app/api/v1/results?limit=10"
JavaScript
const res = await fetch("https://flowfiengine.app/api/v1/results?limit=10", {
  headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://flowfiengine.app/api/v1/results?limit=10",
    headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
Response · 200
{
  "ok": true,
  "asOf": "2026-11-12T15:00:00.000Z",
  "gradesIncluded": true,
  "summary": {
    "recordedCount": 1,
    "withPeakCount": 1,
    "reached2x": 1,
    "reached5x": 0,
    "reached10x": 0,
    "reached20x": 0,
    "reached50x": 0,
    "reached100x": 0,
    "reached300x": 0,
    "medianPeakMultiple": 2.927
  },
  "recent": [
    {
      "mint": "FFiTest111111111111111111111111111111111111A",
      "symbol": "TEST",
      "name": "FlowFi Test Token",
      "firstDetectedAt": "2026-11-12T13:25:00.000Z",
      "stage": "early_radar",
      "firstDetectionPriceUsd": 0.000178,
      "firstDetectionMarketCapUsd": 178000,
      "peakMultiple": 2.927,
      "peakAt": "2026-11-12T14:10:00.000Z",
      "currentMultiple": 2.3146,
      "grades": {
        "h1": 1.84,
        "h6": 2.31,
        "h24": null
      },
      "status": "above_baseline",
      "onMapNow": true
    }
  ],
  "usage": {
    "plan": "builder",
    "minute": {
      "used": 1,
      "limit": 120,
      "resetsAt": "2026-11-12T15:01:00.000Z"
    },
    "month": {
      "used": 1,
      "limit": 250000,
      "resetsAt": "2026-12-01T00:00:00.000Z"
    }
  },
  "requestId": "req_example"
}
GET /api/v1/token/{mint}One token
curl
curl -H "Authorization: Bearer $FLOWFI_KEY" \
  "https://flowfiengine.app/api/v1/token/<mint>"
JavaScript
const res = await fetch("https://flowfiengine.app/api/v1/token/<mint>", {
  headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://flowfiengine.app/api/v1/token/<mint>",
    headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
Response · 200
{
  "ok": true,
  "mint": "FFiTest111111111111111111111111111111111111A",
  "observedAt": "2026-11-12T15:00:00.000Z",
  "stage": "validated",
  "onMapNow": true,
  "firstDetectedAt": "2026-11-12T13:25:00.000Z",
  "token": {
    "mint": "FFiTest111111111111111111111111111111111111A",
    "symbol": "TEST",
    "name": "FlowFi Test Token",
    "imageUrl": null,
    "stage": "validated",
    "state": "ACTIVE",
    "activity": 72,
    "buyers": 184,
    "priceUsd": 0.000412,
    "marketCapUsd": 412000,
    "liquidityUsd": 58400,
    "volumeH1": 41200,
    "volumeH24": 388000,
    "changeH1": 18.4,
    "buys1h": 512,
    "sells1h": 377,
    "ageMinutes": 95,
    "hasX": true,
    "theme": "meme",
    "firstDetectedAt": "2026-11-12T13:25:00.000Z",
    "firewall": "passed"
  },
  "signals": {
    "money": {
      "liquidityUsd": 58400,
      "marketCapUsd": 412000,
      "volumeH1": 41200,
      "volumeH24": 388000,
      "buys1h": 512,
      "sells1h": 377,
      "buyShare1h": 0.576,
      "facts": [
        {
          "id": "MARKET",
          "label": "Market",
          "text": "Liquidity $58.4K, market cap $412K.",
          "tone": "neutral"
        },
        {
          "id": "FLOW",
          "label": "Last hour",
          "text": "512 buys and 377 sells in the last hour.",
          "tone": "neutral"
        }
      ]
    },
    "attention": {
      "activity": 72,
      "buyers": 184,
      "x": {
        "state": "EMERGING",
        "uniqueAuthors": 7,
        "observedPosts": 11,
        "coverage": "SAMPLED",
        "status": "ACTIVE",
        "checkedAt": "2026-11-12T14:55:00.000Z"
      },
      "facts": []
    },
    "safety": {
      "firewall": "passed",
      "firewallCheckedAt": "2026-11-12T14:58:00.000Z",
      "facts": [
        {
          "id": "HOLDERS",
          "label": "Holders",
          "text": "The top 10 wallets hold 18% of the supply.",
          "tone": "good"
        }
      ]
    }
  },
  "firewall": {
    "verdict": "passed",
    "checkedAt": "2026-11-12T14:58:00.000Z"
  },
  "lens": {
    "aligned": 2,
    "total": 3,
    "agree": [
      "FLOW",
      "HOLDERS"
    ],
    "watch": [
      "MARKET"
    ]
  },
  "outcome": {
    "mint": "FFiTest111111111111111111111111111111111111A",
    "symbol": "TEST",
    "name": "FlowFi Test Token",
    "firstDetectedAt": "2026-11-12T13:25:00.000Z",
    "stage": "early_radar",
    "firstDetectionPriceUsd": 0.000178,
    "firstDetectionMarketCapUsd": 178000,
    "peakMultiple": 2.927,
    "peakAt": "2026-11-12T14:10:00.000Z",
    "currentMultiple": 2.3146,
    "grades": {
      "h1": 1.84,
      "h6": 2.31,
      "h24": null
    },
    "status": "above_baseline",
    "onMapNow": true
  },
  "usage": {
    "plan": "builder",
    "minute": {
      "used": 1,
      "limit": 120,
      "resetsAt": "2026-11-12T15:01:00.000Z"
    },
    "month": {
      "used": 1,
      "limit": 250000,
      "resetsAt": "2026-12-01T00:00:00.000Z"
    }
  },
  "requestId": "req_example"
}
GET /api/v1/marketMarket
curl
curl -H "Authorization: Bearer $FLOWFI_KEY" \
  "https://flowfiengine.app/api/v1/market"
JavaScript
const res = await fetch("https://flowfiengine.app/api/v1/market", {
  headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://flowfiengine.app/api/v1/market",
    headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
Response · 200
{
  "ok": true,
  "markets": [
    {
      "id": "solana",
      "name": "Solana",
      "now": {
        "scanned": 1840,
        "passed": 64,
        "validated": 12,
        "earlyRadar": 10
      },
      "today": {
        "detected": 96,
        "earlyRadar": 81,
        "validated": 15
      },
      "firewall": {
        "checked": 1310,
        "keptOut": 402,
        "passed": 908,
        "keptOutByReason": {
          "LAUNCH_BUNDLE_HEAVY": 140,
          "SNIPERS_HEAVY": 118,
          "BOT_LADDER": 96,
          "WASH_TRADING": 48
        }
      },
      "results": {
        "tracked": 1,
        "withPeak": 1,
        "reached2x": 1,
        "reached5x": 0,
        "reached10x": 0,
        "medianPeakMultiple": 2.927
      },
      "trackingSince": null
    },
    {
      "id": "robinhood",
      "name": "Robinhood Chain",
      "now": null,
      "today": null,
      "firewall": null,
      "results": {
        "tracked": 1,
        "withPeak": 1,
        "reached2x": 1,
        "reached5x": 0,
        "reached10x": 0,
        "medianPeakMultiple": 3.1
      },
      "trackingSince": "2026-11-10T00:00:00.000Z"
    }
  ],
  "moreMarkets": [],
  "moreMarketsPlan": null,
  "usage": {
    "plan": "builder",
    "minute": {
      "used": 1,
      "limit": 120,
      "resetsAt": "2026-11-12T15:01:00.000Z"
    },
    "month": {
      "used": 1,
      "limit": 250000,
      "resetsAt": "2026-12-01T00:00:00.000Z"
    }
  },
  "requestId": "req_example"
}
GET /api/v1/statusStatus
curl
curl "https://flowfiengine.app/api/v1/status"
JavaScript
const res = await fetch("https://flowfiengine.app/api/v1/status");
const data = await res.json();
Python
import requests

data = requests.get("https://flowfiengine.app/api/v1/status").json()
Response · 200
{
  "ok": true,
  "status": "ok",
  "version": "v1",
  "checkedAt": "2026-11-12T15:00:00.000Z",
  "data": {
    "snapshotAt": "2026-11-12T14:59:40.000Z",
    "snapshotAgeSeconds": 20,
    "resultsAt": "2026-11-12T14:57:00.000Z",
    "resultsAgeSeconds": 180
  }
}

Endpoints

  • /api/v1/validatedTokens on Validated now (they passed FlowFi's checks), ranked by Live Activity, with the themes heating up.Built
  • /api/v1/early-radarThe Early Radar now: young tokens with recent activity, before they reach Validated.Built
  • /api/v1/resultsFlowFi's track record: how many tokens reached 2×, 5×, 10× and more from FlowFi's first detection, and the most recent ones.Built
  • /api/v1/token/{mint}FlowFi's read of one tracked token: Money / Attention / Safety signals, the Firewall verdict, its stage and its outcome since FlowFi's first detection.Built
  • /api/v1/marketThe state of each market FlowFi tracks: scanned, passed, Early Radar and Validated now, detected today, kept out by the Firewall by reason, and outcomes.Built
  • /api/v1/statusWhether the API is up and how fresh FlowFi's data is. No key needed; not counted.Built
  • Webhooksvalidated.new and catch.milestone (2×, 5×, 10×), signed, delivered within the minute.Soon
  • Outcomes exportThe historical outcomes, as a file, for Pro API and Scale.Soon

Usage limits

Each plan has a monthly quota and a per-minute rate, across all your keys (plans). The month resets at 00:00 UTC on the 1st. Past the quota the API answers 429 with a link to upgrade. Test keys never count.

Errors

401
missing_key: no Authorization header.
401
invalid_key: a wrong, revoked or expired key.
400
key_in_query: a key was put in the URL. Send it in the header.
400
bad_request: a parameter is not valid.
403
scope_required: the key doesn't have this endpoint's scope.
403
plan_required: this endpoint isn't part of your plan.
404
not_found: FlowFi has no stored read for this token.
429
rate_limited: too many calls this minute.
429
quota_exceeded: this month's calls are used up. Upgrade for more.
503
unavailable: try again in a minute.

Information only, not financial advice. Always DYOR.