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/v1

New 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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Credits & 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 POST

The 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 credits

The 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 paramValuesMeaning
limit1–200, default 60How many launches to return.
beforeunix secondsReturn launches strictly before this time (paging).
bundlerall · confirmed · proxima · unknownAttribution filter; 'confirmed' is Proxima ≥ 0.6.
launchpadall · pumpfun · stonkLaunchpad the token was created on.
bundled1 · 0Only launches with a same-slot bundle.
minPct / maxPct0–100Dev + bundle share of supply.
minAth / maxAthUSDAll-time-high market cap bounds.
qstringTicker, 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 credits

One 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 credits

Every 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 credits

Launch 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 credits

One 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 credits

Tracked 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 credits

How 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 paramValuesMeaning
days1–30, default 7Lookback window.
chainall · solana · robinhoodRestrict to one chain.
launchpadall · pumpfun · stonk · ponsRestrict to one launchpad.
maxPct0–100Only launches at or below this dev + bundle supply share.
today1 · 00 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 credit

Tracker 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 credits

A 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 }
      }
    ]
  }
}

POST/bundles/launches/batch

2 credits per launch

Up 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 credits

Counts, 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 paramValuesMeaning
hoursBack0.1–168, default 24The window.
untilHoursAgo0–167End the window this long ago (yesterday: 48 / 24).
groupBynone · team · creator · launchpad · hour · day · …How to group.
sortrecent · launches · pnl · ath · spent · totalPct · walletsHighest first.
limit1–100, default 25Rows or groups returned.
minPct · minAth · minPnlUsd · exited · creator · teamIdFilters.
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 row

Launches 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.ndjson

GET/kols/token/{address}

3 credits

The 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.

EndpointCredits
/bundles/launches
Recent Solana bundled launches
5
/bundles/launches/{mint}
One launch (stored only)
5
/bundles/launches/{mint}/trades
The group's buys, sells and transfers out
2
/bundles/armed
Bundler wallets armed or dispersing
10
/bundles/stats
Tracker counters
1
/bundles/robinhood/launches
Robinhood declared bundles
5
/bundles/robinhood/launches/{token}
One Robinhood launch
5
/bundles/robinhood/armed
Funded teams not yet launched
10
/bundles/robinhood/masters
Master wallets funding teams
5
/bundles/robinhood/stats
Robinhood watcher counters
1
/bundles/teams
Launch 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/wallets
Armed Solana wallets (signals)
10
/bundles/watch/wallets/{address}
One watched wallet
10
/bundles/watch/robinhood
Funded Robinhood teams (signals)
10
/bundles/watch/robinhood/{tx}
One funding batch
10
/bundles/profitability
Bundling profitability breakdown
10
/bundles/wallets/{address}
A wallet across every tracked launch
5
/bundles/links
Launches that linked an X / site
5
POST/bundles/launches/batch
Up to 50 stored launches, whole records
2 / launch
/bundles/analytics
Counts and rankings over a window
20
/bundles/launches/export
Launches over a range, NDJSON or CSV
1 / row
/kols/leaderboard
KOLs by period, chain, platform
5
/kols/{handle}
One KOL: positions, recent trades
5
/kols/{handle}/copy
Copy 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/buys
Tokens several KOLs bought
5
/kols/consensus/holdings
Tokens several KOLs hold
5
/kols/platforms
Tracked platforms
1
/kols/stats
KOL tracker counters
1
POST/wallet-flags
Which wallets were bought on a marketplace (per 10 addresses, up to 500)
1 / 10
/streams/launches
Live launches (SSE)
2 / launch
/streams/signals
Armed wallets (SSE)
10 / event
/streams/teams
Team launches (SSE)
5 / event
/streams/kol-trades
KOL trades (SSE)
1 / trade

Live streams

Server-Sent Events

Data 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 delivery

Your 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

v1

Everything 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 } }
StatusCodeMeaning
401INVALID_API_KEYThe key is unknown or malformed.
402INSUFFICIENT_CREDITSNot enough credits; carries required and remaining.
403KEY_REVOKED / SCOPE_DENIEDKey revoked, or cannot reach this route.
404NOT_FOUNDNo such resource (free — not billed).
429RATE_LIMITEDToo many requests; see Retry-After.
503SERVICE_BUSYShed 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"])