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 -H "Authorization: Bearer $FLOWFI_KEY" \
"https://flowfiengine.app/api/v1/validated"
const res = await fetch("https://flowfiengine.app/api/v1/validated", {
headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
import os, requests
r = requests.get(
"https://flowfiengine.app/api/v1/validated",
headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
{
"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 -H "Authorization: Bearer $FLOWFI_KEY" \
"https://flowfiengine.app/api/v1/early-radar"
const res = await fetch("https://flowfiengine.app/api/v1/early-radar", {
headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
import os, requests
r = requests.get(
"https://flowfiengine.app/api/v1/early-radar",
headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
{
"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 -H "Authorization: Bearer $FLOWFI_KEY" \
"https://flowfiengine.app/api/v1/results?limit=10"
const res = await fetch("https://flowfiengine.app/api/v1/results?limit=10", {
headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
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()
{
"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 -H "Authorization: Bearer $FLOWFI_KEY" \
"https://flowfiengine.app/api/v1/token/<mint>"
const res = await fetch("https://flowfiengine.app/api/v1/token/<mint>", {
headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
import os, requests
r = requests.get(
"https://flowfiengine.app/api/v1/token/<mint>",
headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
{
"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 -H "Authorization: Bearer $FLOWFI_KEY" \
"https://flowfiengine.app/api/v1/market"
const res = await fetch("https://flowfiengine.app/api/v1/market", {
headers: { Authorization: `Bearer ${process.env.FLOWFI_KEY}` },
});
const data = await res.json();
import os, requests
r = requests.get(
"https://flowfiengine.app/api/v1/market",
headers={"Authorization": f"Bearer {os.environ['FLOWFI_KEY']}"},
)
data = r.json()
{
"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 "https://flowfiengine.app/api/v1/status"
const res = await fetch("https://flowfiengine.app/api/v1/status");
const data = await res.json();
import requests
data = requests.get("https://flowfiengine.app/api/v1/status").json()
{
"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.BuiltWebhooksvalidated.new and catch.milestone (2×, 5×, 10×), signed, delivered within the minute.SoonOutcomes 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.