API docs
Authentication, endpoints, examples and credit costs
Introduction
The GateKept API serves the same bundle intelligence the app runs on, over simple JSON endpoints — authenticated with an API key and paid for with prepaid credits. Endpoints are GET except two that take a JSON body (POST), and answer { "data": … }; live data comes as streams or webhooks. Base URL:
https://api.gatekept.io/api/v1New to GateKept? The product guide explains what each dataset means before you wire it up.
Authentication
Send your key on every request as a bearer token (or the x-api-key header). Manage keys on your account page; a key is shown once, so store it safely.
Authorization: Bearer gk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxCredits & billing
Each endpoint costs a fixed whole number of credits (1 credit ≈ $0.001); a batch, an export and wallet flags are priced per launch, row or ten addresses, and charged only for what they return. Only successful responses are billed — a 4xx you caused, and any 5xx, cost nothing. Streams and webhooks are charged per event delivered. Every billed response carries:
X-Credits-Cost— Credits charged for this request.X-Credits-Remaining— Your balance after this request.X-Credits-Reserved— On an export, the most it can cost, held while it streams; rows not sent are given back.X-Api-Version— The response format's version (1).Retry-After— On a 429, seconds to wait before retrying.
Endpoints
GET unless marked POSTThe worked examples below cover the endpoints most people start with. The full list with credit costs is at the end of this section. Example responses are trimmed to the fields that matter; a real response carries the complete object.
GET/bundles/launches
5 creditsThe newest Solana bundled launches, newest first. Page with before (or the returned nextCursor), filter by launchpad, bundler confidence, supply share and all-time-high, or search with q.
| Query param | Values | Meaning |
|---|---|---|
limit | 1–200, default 60 | How many launches to return. |
before | unix seconds | Return launches strictly before this time (paging). |
bundler | all · confirmed · proxima · unknown | Attribution filter; 'confirmed' is Proxima ≥ 0.6. |
launchpad | all · pumpfun · stonk | Launchpad the token was created on. |
bundled | 1 · 0 | Only launches with a same-slot bundle. |
minPct / maxPct | 0–100 | Dev + bundle share of supply. |
minAth / maxAth | USD | All-time-high market cap bounds. |
q | string | Ticker, name or mint — up to 10, comma-separated. |
Example request
curl "https://api.gatekept.io/api/v1/bundles/launches?launchpad=pumpfun&minAth=50000&limit=20" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"launches": [
{
"mint": "Fewc7m2v…pump",
"chain": "solana",
"launchpad": { "id": "pumpfun", "name": "pump.fun" },
"name": "Example Token",
"symbol": "EXMPL",
"imageUrl": "https://img.gatekept.io/…",
"slot": 301897421,
"blockTime": 1733680512,
"position": 3,
"creator": { "address": "9xQe…", "tokens": 12000000, "pct": 1.2, "spent": 0.85 },
"bundle": {
"isBundled": true,
"walletsPct": 14.2,
"totalPct": 15.4,
"walletsSpent": 8.6,
"totalSpent": 9.45,
"wallets": [ { "address": "3kP9…", "tokens": 4200000, "pct": 0.42 } ]
},
"attribution": {
"bundler": "proxima",
"bundlerName": "Proxima",
"confidence": 0.82,
"signals": ["lut-reuse", "exact-tip"]
},
"ath": {
"marketCapUsd": 1870000,
"at": 1733681044,
"source": "pumpfun",
"graduated": false
},
"pnl": {
"investedSol": 9.45,
"proceedsSol": 22.1,
"heldTokens": 3100000,
"movedTokens": 0,
"heldPct": 0.31,
"soldPct": 15.09,
"movedPct": 0,
"devHeldPct": 0,
"walletsHeldPct": 0.31,
"heldByWallet": { "9xQe…": 0, "3kP9…": 3100000 },
"heldValueSol": 4.8,
"realizedSol": 13.2,
"unrealizedSol": 1.6,
"totalSol": 14.8,
"investedUsd": 1890,
"proceedsUsd": 4420,
"heldValueUsd": 960,
"exitValueUsd": 820,
"realizedUsd": 2640,
"unrealizedUsd": 320,
"totalUsd": 2960,
"feesSol": 1.1,
"feesUsd": 220,
"feeRate": 0.05,
"lastPriceSol": 0.00000155,
"lastTradeAt": 1733681200,
"exited": false,
"trackedUntil": "2025-10-10T09:21:48.771Z",
"updatedAt": "2025-10-08T09:21:40.000Z"
},
"detectedAt": "2025-10-08T09:15:12.004Z",
"updatedAt": "2025-10-08T09:21:48.771Z"
}
],
"nextBefore": 1733680400,
"nextCursor": "eyJiIjoxNzMz…"
}
}pnl is the operator group’s running profit and loss on its own launch — what the creator and bundle wallets put in (investedSol), took out in sells (proceedsSol/realizedSol), and what they still hold (heldValueSol/unrealizedSol), accumulated from on-chain trades. The held value is what selling the bag into the curve or pool would return now, worked from the venue’s constant product at the last price: a small bag reads as price × tokens, while a group holding most of the supply is bounded by the SOL actually in the pool rather than marked at a price only the last token fetched. Tokens handed off to wallets we do not track leave the position and are counted in movedTokens, so a group that rotates its supply out does not read as still holding. heldPct, soldPct and movedPct give the same three as a share of total supply, to set against bundle.totalPct: a launch that bundled 15.4% and now reads heldPct 0.31 has all but a sliver out the door. devHeldPct and walletsHeldPct split the held share between the creator and the bundle wallets, and heldByWallet lists the tokens each group wallet still holds. All of these are null on summaries written before they were recorded. Figures are in SOL and in USD at the last update’s SOL price; totalSol = realised + unrealised. It is null until a position is tracked, and exited turns true once the group has sold out or tracking stopped. A position is reviewed 48 hours after launch and then daily: a group still holding more than $1,000 is kept another 24 hours (trackedUntil says when the next review is), one holding less is retired. Lists and the single-launch endpoint both return it, live or from durable storage.
GET/bundles/launches/{mint}
5 creditsOne stored launch by its mint, plus the launches funded by the same master wallet(s) (cluster), prior appearances of its wallets (knownWallets) and the market cap the team’s own buys reached (marketCap). Stored launches only — it never triggers a fresh on-chain read.
Example request
curl "https://api.gatekept.io/api/v1/bundles/launches/Fewc7m2v…pump" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"launch": { "mint": "Fewc7m2v…pump", "symbol": "EXMPL", "bundle": { "totalPct": 15.4 }, "…": "" },
"cluster": [ { "mint": "HNHb…pump", "symbol": "CAT", "…": "" } ],
"knownWallets": [
{ "address": "3kP9…", "role": "bundle", "launches": ["Fewc7m2v…pump"], "bundler": "proxima" }
],
"marketCap": { "teamMarketCapUsd": 92000, "naturalBuysUsd": 18400 }
}
}GET/bundles/launches/{mint}/trades
2 creditsEvery trade of the operator group in its own launch, oldest first: the launch buys (one per wallet), each later buy or sell, and each transfer of tokens out of the group. Booked by the P/L ledger from the block stream, so a sale through a bundler program that pays its proceeds to escrows is a sell with the SOL the escrows received. Supply the group hands to one of its own fresh wallets (an escrow-funded buy or a plain transfer) is recorded as a handoff for the receiving wallet, not as a sale, and that wallet’s later sells count as the group’s. The bundler’s cut of a sale (a Proxima wallet sends 2.5% of each sale’s proceeds, less on some licences, to a relay right after it) is a fee row with tokens 0 and sol the amount. Tokens a group wallet puts in a vesting contract are a lock (still the group’s, valued with what it holds) and tokens it destroys a burn (a realised loss); a relay tip a group wallet pays on its own is a tip row; the launch’s pnl sums them as feesSol. role is dev for the creator, holder for a wallet the supply was handed on to, and bundle for a bundle wallet; time is the block’s unix time, which is what a candle chart marks. The live stream’s pnl event carries new trades as trades on each change. Up to 4,000 rows per launch: one with more keeps its first 500 (the launch buys, the hand-offs and the first exits) and the newest of the rest, fee and tip rows going first.
Example request
curl "https://api.gatekept.io/api/v1/bundles/launches/Fewc7m2v…pump/trades" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"trades": [
{ "signature": "4ZJo…", "wallet": "5RJu…", "role": "dev", "side": "buy", "tokens": 20000000, "sol": 0.5785, "slot": 455268530, "time": 1791638117 },
{ "signature": "4ZJo…", "wallet": "HNEH…", "role": "bundle", "side": "buy", "tokens": 144357225.14, "sol": 4.9174, "slot": 455268530, "time": 1791638117 },
{ "signature": "dqia…", "wallet": "HNEH…", "role": "bundle", "side": "sell", "tokens": 144357225.14, "sol": 10.848, "slot": 455268532, "time": 1791638118},
{ "signature": "5kQw…", "wallet": "HNEH…", "role": "bundle", "side": "fee", "tokens": 0, "sol": 0.542, "slot": 455268533, "time": 1791638119 }
]
}
}GET/bundles/teams
5 creditsLaunch teams — operators grouped by the wallets they share across launches — with their track record: launch count, average all-time-high, graduation rate, the average profit or loss of their own wallets per launch (avgPnlUsd, over the pnlKnown launches with a tracked position; sort with sort=pnl, filter with minAvgPnl / maxAvgPnl), how fast they sell out (exitTiming: average seconds from launch to the group's first sell, to half of its bundle gone and to 90% gone, over the launches that got there, and the average market cap at each: avg*CapUsd) and the key wallets behind them. The median* fields remain for existing integrations; prefer the avg* ones.
Example request
curl "https://api.gatekept.io/api/v1/bundles/teams?limit=20" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"teams": [
{
"id": "team_9f2a…",
"label": "IshiGo squad",
"chains": ["solana"],
"launchpads": [{ "id": "pumpfun", "name": "pump.fun" }],
"launchCount": 14,
"walletCount": 9,
"avgTotalPct": 16.8,
"avgAthUsd": 640000,
"bestAthUsd": 1870000,
"avgNaturalBuysUsd": 412000,
"avgPnlUsd": 18400,
"avgRealizedPnlUsd": 15100,
"totalPnlUsd": 202400,
"pnlKnown": 11,
"exitTiming": {
"avgFirstSellS": 55,
"firstSellKnown": 11,
"avgHalfOutS": 310,
"halfOutKnown": 10,
"avgMostOutS": 1500,
"mostOutKnown": 8,
"avgAllOutS": 2400,
"allOutKnown": 6,
"halfOutWithin5m": 6,
"tracked": 11,
"avgFirstSellCapUsd": 24000,
"avgHalfOutCapUsd": 61000,
"avgMostOutCapUsd": 52000,
"avgAllOutCapUsd": 47000
},
"graduatedCount": 3,
"recentLaunches": [
{ "id": "Fewc7m2v…pump", "symbol": "EXMPL", "athUsd": 1870000, "bundled": true }
]
}
],
"nextCursor": null
}
}GET/bundles/teams/{id}
5 creditsOne team in full: the summary above plus every launch and every wallet attributed to it. Use /bundles/teams/launch/{launchId} (3 credits) to go the other way — from a launch to the team behind it.
Example request
curl "https://api.gatekept.io/api/v1/bundles/teams/team_9f2a…" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"id": "team_9f2a…",
"label": "IshiGo squad",
"launchCount": 14,
"launches": [
{ "id": "Fewc7m2v…pump", "symbol": "EXMPL", "blockTime": 1733680512, "athUsd": 1870000 }
],
"wallets": [ { "address": "3kP9…", "role": "bundle", "launchCount": 11 } ]
}
}GET/bundles/armed
10 creditsTracked bundler wallets that were just funded (armed) or are dispersing — a leading signal that a team is about to launch. signal.deltaSol is the funding move and since is when it happened.
Example request
curl "https://api.gatekept.io/api/v1/bundles/armed" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"wallets": [
{
"address": "7thxA1…pump",
"role": "bundle",
"launches": ["Fewc7m2v…pump"],
"bundler": "proxima",
"firstSeenAt": "2025-09-30T12:04:00.000Z",
"lastLaunchAt": "2025-10-08T08:40:11.000Z",
"balanceSol": 42.5,
"signal": { "state": "armed", "deltaSol": 40.0, "since": "2025-10-08T09:28:03.000Z" }
}
]
}
}GET/bundles/profitability
10 creditsHow bundling actually pays, over the last days (1–30): totals, a daily / hourly / weekday breakdown, the split by launchpad, the top launches, and the busiest teams in the window. Filter by chain, launchpad and maxPct supply share.
| Query param | Values | Meaning |
|---|---|---|
days | 1–30, default 7 | Lookback window. |
chain | all · solana · robinhood | Restrict to one chain. |
launchpad | all · pumpfun · stonk · pons | Restrict to one launchpad. |
maxPct | 0–100 | Only launches at or below this dev + bundle supply share. |
today | 1 · 0 | 0 leaves out the current, partial UTC day. |
Example request
curl "https://api.gatekept.io/api/v1/bundles/profitability?days=7&chain=solana" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"days": 7,
"chain": "solana",
"launchpad": "all",
"printCapUsd": 250000,
"totals": {
"launches": 2143,
"measured": 1987,
"costUsd": 1850000,
"ceilingUsd": 7400000,
"peakPnlUsd": 5550000,
"profitable": 1240,
"graduated": 61
},
"daily": [ { "day": "2025-10-07", "launches": 318, "peakPnlUsd": 820000 } ],
"launchpads": [ { "launchpad": "pumpfun", "launches": 1760, "peakPnlUsd": 4100000 } ],
"topLaunches": [
{ "id": "Fewc7m2v…pump", "symbol": "EXMPL", "costUsd": 9450, "ceilingUsd": 176000, "peakPnlUsd": 166550 }
]
}
}GET/bundles/stats
1 creditTracker counters: how much has been seen all-time and in the last hour, how many wallets are tracked and armed, and whether the watcher is live. The cheapest endpoint — good for a health check.
Example request
curl "https://api.gatekept.io/api/v1/bundles/stats" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"watching": true,
"launchesSeen": 184233,
"bundledSeen": 29561,
"proximaSeen": 21044,
"lastHour": { "launches": 412, "bundled": 73, "proxima": 51 },
"trackedWallets": 8820,
"armedWallets": 17,
"lastSlot": 301902233,
"startedAt": "2025-10-01T00:00:00.000Z"
}
}GET/bundles/wallets/{address}
5 creditsA wallet across every launch the tracker recorded: the role it played in each — creator, bundle, master (funded the bundle), rotation (received the supply after launch), sniper — how those launches went, and the launch team it belongs to. The check before a bot touches a dev's next token. A wallet never seen (inTrackedLaunches: 0) is an answer too, and is charged. Solana or Robinhood (0x…) addresses.
Example request
curl "https://api.gatekept.io/api/v1/bundles/wallets/9xQe…?limit=10" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"Example response
{
"data": {
"wallet": "9xQe…",
"chain": "solana",
"inTrackedLaunches": 12,
"roles": { "creator": { "launches": 9, "firstAt": "…", "lastAt": "…" } },
"team": { "id": "solana:M0…", "label": "IshiGo squad", "launchCount": 31, "avgAthUsd": 64000 },
"launches": [
{
"mint": "Fewc7m2v…pump",
"roles": ["creator"],
"sharePct": 4.2,
"launch": { "symbol": "EXMPL", "totalPct": 38.5, "athUsd": 210000, "devSold": true }
}
]
}
}GET/bundles/links
5 creditsHas this X account, website or Telegram launched tokens before, and what became of them? Repeat ruggers reuse their socials. Give one of x, website or telegram as you would write it (a handle, a URL, a domain). totals covers every launch that linked it.
curl "https://api.gatekept.io/api/v1/bundles/links?x=@someproject" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"POST/bundles/launches/batch
2 credits per launchUp to 50 launches in one call, whole records, from what the tracker stored — nothing is analysed on demand. Mints it has no record of come back in missing and are not charged.
curl -X POST "https://api.gatekept.io/api/v1/bundles/launches/batch" \
-H "Authorization: Bearer $GATEKEPT_API_KEY" -H "Content-Type: application/json" \
-d '{"mints":["Fewc7m2v…pump","3c2kCVJc…pump"]}'GET/bundles/analytics
20 creditsCounts, totals and rankings over a window of up to a week, read by the database: the launches themselves, or grouped by team, creator, launchpad, bundler, hour, day or the website / twitter / telegram they linked. The same question within a minute is answered from cache.
| Query param | Values | Meaning |
|---|---|---|
hoursBack | 0.1–168, default 24 | The window. |
untilHoursAgo | 0–167 | End the window this long ago (yesterday: 48 / 24). |
groupBy | none · team · creator · launchpad · hour · day · … | How to group. |
sort | recent · launches · pnl · ath · spent · totalPct · wallets | Highest first. |
limit | 1–100, default 25 | Rows or groups returned. |
minPct · minAth · minPnlUsd · exited · creator · teamId | Filters. |
curl "https://api.gatekept.io/api/v1/bundles/analytics?hoursBack=24&groupBy=team&sort=pnl" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"GET/bundles/launches/export
1 credit per rowLaunches between from and to (unix seconds), newest first, streamed: whole records as NDJSON (one per line) or the feed figures as CSV (format=csv). At most 5,000 rows a call — page by asking again with to set to the last row's blockTime. For backtesting.
curl "https://api.gatekept.io/api/v1/bundles/launches/export?from=1762000000&to=1763000000&limit=5000" \
-H "Authorization: Bearer $GATEKEPT_API_KEY" > launches.ndjsonGET/kols/token/{address}
3 creditsThe KOLs who traded a token, first buyer first, with their Copy Score and whether they were an insider of the launch. The other KOL endpoints — the leaderboard, a KOL's positions and trades, the Copy Score breakdown, consensus buys — are in the table below.
curl "https://api.gatekept.io/api/v1/kols/token/Fewc7m2v…pump?chain=solana" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"All endpoints
The Robinhood endpoints return the same launch and team shapes for the Robinhood chain; the watch endpoints return the armed-wallet shape above.
| Endpoint | Credits |
|---|---|
/bundles/launchesRecent Solana bundled launches | 5 |
/bundles/launches/{mint}One launch (stored only) | 5 |
/bundles/launches/{mint}/tradesThe group's buys, sells and transfers out | 2 |
/bundles/armedBundler wallets armed or dispersing | 10 |
/bundles/statsTracker counters | 1 |
/bundles/robinhood/launchesRobinhood declared bundles | 5 |
/bundles/robinhood/launches/{token}One Robinhood launch | 5 |
/bundles/robinhood/armedFunded teams not yet launched | 10 |
/bundles/robinhood/mastersMaster wallets funding teams | 5 |
/bundles/robinhood/statsRobinhood watcher counters | 1 |
/bundles/teamsLaunch teams by shared wallets | 5 |
/bundles/teams/launch/{launchId}The team behind a launch | 3 |
/bundles/teams/{id}One team with launches + wallets | 5 |
/bundles/watch/walletsArmed Solana wallets (signals) | 10 |
/bundles/watch/wallets/{address}One watched wallet | 10 |
/bundles/watch/robinhoodFunded Robinhood teams (signals) | 10 |
/bundles/watch/robinhood/{tx}One funding batch | 10 |
/bundles/profitabilityBundling profitability breakdown | 10 |
/bundles/wallets/{address}A wallet across every tracked launch | 5 |
/bundles/linksLaunches that linked an X / site | 5 |
POST/bundles/launches/batchUp to 50 stored launches, whole records | 2 / launch |
/bundles/analyticsCounts and rankings over a window | 20 |
/bundles/launches/exportLaunches over a range, NDJSON or CSV | 1 / row |
/kols/leaderboardKOLs by period, chain, platform | 5 |
/kols/{handle}One KOL: positions, recent trades | 5 |
/kols/{handle}/copyCopy Score breakdown | 5 |
/kols/token/{address}KOLs who traded a token | 3 |
/kols/team/{teamId}KOLs who buy a team's launches | 5 |
/kols/consensus/buysTokens several KOLs bought | 5 |
/kols/consensus/holdingsTokens several KOLs hold | 5 |
/kols/platformsTracked platforms | 1 |
/kols/statsKOL tracker counters | 1 |
POST/wallet-flagsWhich wallets were bought on a marketplace (per 10 addresses, up to 500) | 1 / 10 |
/streams/launchesLive launches (SSE) | 2 / launch |
/streams/signalsArmed wallets (SSE) | 10 / event |
/streams/teamsTeam launches (SSE) | 5 / event |
/streams/kol-tradesKOL trades (SSE) | 1 / trade |
Live streams
Server-Sent EventsData as it happens instead of polling: new launches and their updates, armed and dispersing wallets, launches by known teams, KOL trades. Each is a long-lived GET answering text/event-stream; filter in the query string and pay only for the events you receive. Send the key as Authorization: Bearer — a browser EventSource cannot, so read streams from a server.
/streams/launches— launch (2 credits) as one is detected, update (free, up to 10 per launch) as its analysis changes. Filters: events, launchpad, bundled, bundler, organic, minPct, maxPct./streams/signals— armed / dispersing Solana bundler wallets and Robinhood funding batch events (10 credits). Filters: chain, state./streams/teams— launch by a known team, with the team and the wallets that tied it (5 credits). Filter: teams (ids)./streams/kol-trades— trade by a tracked KOL (1 credit). Filters: kols (handles), side, chain, minUsd.
Events carry an id: reconnect with Last-Event-ID to get what you missed in the last 5 minutes. A ping comment comes every 15 s; a stream closes after an hour (reconnect to carry on). Up to 3 streams per key. When your balance runs out the stream sends credits_exhausted and closes.
curl -N "https://api.gatekept.io/api/v1/streams/launches?minPct=20&bundler=confirmed" \
-H "Authorization: Bearer $GATEKEPT_API_KEY"
id: lq3k-1042
event: launch
data: {"mint":"Fewc7m2v…pump","bundle":{"totalPct":38.5,…},…}Webhooks
2 credits per deliveryYour alerts — watched team launches, armed wallets, exit moments, alert rules, watched wallets and KOLs — posted to your URL as they fire, and again when one changes (a likely launch confirmed or withdrawn). Set the URL on your account page; what alerts you get is set up the same way as on the site. Deliveries need an active API key and credits; a failure (network, 5xx, 429) is retried after 30 s and 2 min, and 50 failures in a row turn the webhook off.
POST https://your-bot.example.com/gatekept
gatekept-event: alert.created
gatekept-delivery: evt_6f1c…
gatekept-signature: t=1763300000,v1=5b7a…
{ "id": "evt_6f1c…", "type": "alert.created", "createdAt": "…",
"alert": { "kind": "launch", "confidence": "likely", "payload": { "teamLabel": "…", "launchId": "…" } } }Check every delivery: compute HMAC-SHA256 of <t>.<raw body> with your secret and compare it with v1; reject a t more than a few minutes old.
import crypto from "node:crypto";
function verify(rawBody, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
return fresh && crypto.timingSafeEqual(Buffer.from(v1, "hex"), Buffer.from(expected, "hex"));
}Versioning
v1Everything here is v1 (/api/v1, X-Api-Version: 1). Within v1 we only add: new endpoints, new optional parameters, new fields in answers and events, new values in enums. We never remove or rename a field, change its type, make it nullable, or make a parameter required — every endpoint's request and answer is pinned in a recorded contract that our build checks. Read answers tolerantly (ignore fields you don't know). A breaking change would come as v2, announced ahead, with v1 kept running beside it.
Errors
{ error: { code, message, requestId } }| Status | Code | Meaning |
|---|---|---|
| 401 | INVALID_API_KEY | The key is unknown or malformed. |
| 402 | INSUFFICIENT_CREDITS | Not enough credits; carries required and remaining. |
| 403 | KEY_REVOKED / SCOPE_DENIED | Key revoked, or cannot reach this route. |
| 404 | NOT_FOUND | No such resource (free — not billed). |
| 429 | RATE_LIMITED | Too many requests; see Retry-After. |
| 503 | SERVICE_BUSY | Shed load; retry shortly (never billed). |
Rate limits
Keys are limited per second (with a short burst). When you exceed it you get a 429 with Retry-After; back off and retry. Heavier endpoints carry their own limits — analytics 30 a minute, exports 10 a minute and two running at once — and answer 503 with Retry-After when busy.
Quickstart
cURL
curl https://api.gatekept.io/api/v1/bundles/launches \
-H "Authorization: Bearer $GATEKEPT_API_KEY"JavaScript
const res = await fetch("https://api.gatekept.io/api/v1/bundles/launches", {
headers: { Authorization: `Bearer ${process.env.GATEKEPT_API_KEY}` },
});
const { data } = await res.json();
console.log(res.headers.get("x-credits-remaining"), data.launches);Python
import os, requests
r = requests.get(
"https://api.gatekept.io/api/v1/bundles/launches",
headers={"Authorization": f"Bearer {os.environ['GATEKEPT_API_KEY']}"},
)
r.raise_for_status()
print(r.headers["x-credits-remaining"], r.json()["data"]["launches"])