LABSCyclops Labs
Open app
CYCLOPS LABSDOCS / API REFERENCEFILE Nº D3

Every endpoint,
callable.

The reference is built from the API’s own OpenAPI document. Pick an operation, fill in its parameters and send it; the answer is the API’s, unedited.

VERSION

Which
version.

API v1

v1 is the path version: a route under /v1 keeps its meaning, and fields are added, never removed or retyped, while it is current. The document is at 2026.10; every addition is in the API changelog (Atom).

TRY IT

Send a
request.

GET /v1/launches

Torch launches with stats and outcomes

Public: no key needed.

PARAMETERS
AUTH (OPTIONAL)
CURL
curl 'https://cyclopslabs.dev/api/v1/launches'
200 response schema
{
  "type": "object"
}
INDEX

156 operations,
23 groups.

Service
  • GET/v1/health

    Liveness check

  • GET/v1/status

    Job freshness and response times

  • GET/v1/config

    Token, tiers and public settings

  • GET/v1/queue

    Scan queue: running, waiting, de-duplicated

  • GET/v1/chains

    Chains the scanner reads

  • GET/v1/changelog

    Engine changelog

  • GET/v1/openapi.json

    This document

  • POST/v1/a/hit

    Cookie-free page view (path and referrer host only)

  • POST/v1/discord/interactions

    Discord interactions endpoint (signed by Discord)

  • GET/v1/incidents

    Public incident log

  • POST/v1/feedback

    Lab feedback; signed-in Holder bug reports enter the Eyes bug bounty

Auth
  • POST/v1/auth/nonce

    Start wallet sign-in

  • POST/v1/auth/verify

    Finish wallet sign-in; returns a session token

Scanner
  • GET/v1/inspect/{q}q

    Point it anywhere: token, wallet, contract or transaction

  • GET/v1/inspect/{q}/streamq

    The same read as server-sent events: progress, then done or error

  • GET/v1/scan/{address}address

    Token scan (includes `extra`: locks, tax history, wash trading and more where available)

  • GET/v1/scan/wallet/{address}address

    Wallet report

  • GET/v1/scan/{address}/receiptaddress

    Signed receipt for the latest scan

  • GET/v1/receipts/key

    Public key that signs scan receipts

  • GET/v1/tx/{hash}hash

    Explain a transaction

  • GET/v1/searchq?

    Tokens by name or ticker, wallets by label

  • GET/v1/trail/{address}address · hops?

    Funding trail, several hops back

  • GET/v1/creator/{address}address

    A creator’s launches and their outcomes

  • GET/v1/smart-money

    Wallets ranked by the outcomes of what they bought

  • POST/v1/bulk/inspect

    Up to 50 addresses: cached results now, the rest queued Holder tier or above.

  • GET/v1/explorer/{address}address

    Compact cached read for explorers: score, label, top observations, badge and link (never starts a scan)

Method
  • GET/v1/flags/accuracy

    How often each flag preceded a collapse

  • GET/v1/score/changelog

    Changes to the scoring, versioned

  • POST/v1/flags/report

    Report a flag as a false positive

  • GET/v1/flags/reportsaddress?

    False-positive reports per flag

  • GET/v1/score/calibration

    Score bucket against the share of launches that later ended badly

  • GET/v1/score/bias

    False-positive rate for first-time against repeat creators

Tokens
  • GET/v1/token/{address}/historyaddress · days?

    Daily holders, price and liquidity

  • GET/v1/token/{address}/holders/historyaddress

    Holder concentration over time

  • GET/v1/badge/token/{file}file

    Embeddable scan badge (SVG); file is <address>.svg

Labels
  • GET/v1/labels/{address}address

    Team label for an address

  • GET/v1/labelsaddress?

    Team and community labels for an address

  • POST/v1/labels/propose

    Propose a community label with evidence Holder tier or above.

  • POST/v1/labels/{id}/voteid

    Agree or disagree; weight follows Eyes rank Holder tier or above.

Launches
  • GET/v1/launchesoutcome? · creator? · limit?

    Torch launches with stats and outcomes

  • GET/v1/launches/stats

    Outcomes of the last 30 days

  • GET/v1/radar

    Scored new launches (15 minutes delayed below Holder)

  • GET/v1/devs

    Creators with collapsed or sold-out launches

  • GET/v1/firehose

    Live launches with first-minute stats (server-sent `launch` events)

  • GET/v1/firehose/recentlimit?

    The latest launches with first-minute stats

  • GET/v1/collapsesdays?

    Launches that collapsed or saw the creator sell out recently, with the score each had before

Reports
  • GET/v1/reports

    Weeks with a public report

  • GET/v1/reports/weeklyweek?

    Weekly report

  • GET/v1/reports/quarters

    Quarters with a public report

  • GET/v1/reports/quarterlyq?

    State of Robinhood Chain launches for a quarter

Datasets
  • GET/v1/datasets

    Downloadable datasets

  • GET/v1/datasets/{file}file · since?

    launches.csv or launches.jsonl

AI
  • POST/v1/ai/summary

    Case summary; every sentence cites observation ids ({enabled:false} when switched off)

  • POST/v1/ai/ask

    Ask a scan a question in plain language

Account
  • GET/v1/me

    Your wallet, tier and settings Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/settings

    Update settings Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/telegram

    Telegram link code Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/data/delete

    Delete watchlists, saved cases, rules, follows, inbox and alert settings; returns a signed receipt Signed-in wallet (Bearer session) or API key.

  • POST/v1/data/receipt/verify

    Check a data-deletion receipt

Alerts
  • GET/v1/me/watch

    Watched tokens Holder tier or above.

  • POST/v1/me/watch

    Watch a token Holder tier or above.

  • DELETE/v1/me/watch/{token}token

    Stop watching Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/rules

    Your alert rules and recent alerts Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/rules

    Create or update (with id) a rule: conditions combined with all/any. Also accepts the short form {token, when: [creator_sells|lp_unlock_near|new_cluster_wallet|tax_change|holder_spike], match} Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/me/rules/{id}id

    Delete a rule Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/alerts

    Alerts sent to you Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/inboxfilter? · limit? · before?

    In-app alert inbox, newest first, with unread counts Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/inbox/count

    Unread alerts (and how many are Act tier) Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/inbox/read

    Mark alerts read (or unread) Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/inbox/delete

    Delete alerts by id, or everything already read Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/alert-prefs

    Quiet hours, folding window, minimum tier for outside channels, weekly recap Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/alert-prefs

    Update alert preferences Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/mutes

    Muted and snoozed tokens Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/mutes

    Mute a token (no hours) or snooze it for 1 to 720 hours Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/me/mutes/{token}token

    Unmute or end a snooze Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/alerts/test

    Send a test alert to one channel; says why it did not deliver Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/alerts/recordhours?

    Your alerts against launch fates: collapse within N hours, hit rate, base rate Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/rules/{id}/templateid

    Share a rule as a template link (?target=1 keeps the token) Signed-in wallet (Bearer session) or API key.

  • GET/v1/rules/template/{code}code

    Open a shared rule template

  • GET/v1/me/wallet-watch

    Wallets connected read-only to the watchlist Holder tier or above.

  • POST/v1/me/wallet-watch

    Read a wallet’s balances and watch every indexed launch it holds Holder tier or above.

  • DELETE/v1/me/wallet-watch/{wallet}wallet

    Disconnect a wallet and unwatch what it added Signed-in wallet (Bearer session) or API key.

  • POST/v1/fates/changes

    Tokens you scanned whose launch outcome changed since you last looked

  • GET/v1/me/follows

    Followed wallets Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/follows

    Follow a wallet; alerted when it buys a launch Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/me/follows/{wallet}wallet

    Unfollow Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/webhooks

    Your webhooks Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/webhooks

    Add a webhook (https, signed with HMAC-SHA256) Holder tier or above.

  • POST/v1/me/webhooks/{id}/testid

    Queue a test delivery Holder tier or above.

  • DELETE/v1/me/webhooks/{id}id

    Remove a webhook Signed-in wallet (Bearer session) or API key.

  • GET/v1/push/key

    Web push public key ({enabled:false} when off)

  • POST/v1/me/push

    Store this browser’s push subscription Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/me/push

    Remove a push subscription Signed-in wallet (Bearer session) or API key.

Email
  • POST/v1/digest/subscribe

    Daily digest and weekly newsletter, double opt-in

  • GET/v1/digest/confirmtoken?

    Confirm an email address

  • GET/v1/digest/unsubscribetoken?

    Unsubscribe

Lab
  • GET/v1/me/investigations

    Saved investigations for your wallet Signed-in wallet (Bearer session) or API key.

  • PUT/v1/me/investigations

    Replace your saved investigations (up to 200 items, 256 KB) Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/labels

    Your private address book Signed-in wallet (Bearer session) or API key.

  • PUT/v1/me/labels

    Replace your private address book (up to 2000 labels, 256 KB) Signed-in wallet (Bearer session) or API key.

Keys
  • GET/v1/me/keys

    Your API keys with usage Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/keys

    Create a key at or below your tier Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/me/keys/{id}id

    Revoke a key Signed-in wallet (Bearer session) or API key.

  • POST/v1/keys/instant

    One wallet signature in, a free-tier (or your tier) key and a session out

  • POST/v1/keys/anonymous

    A free-tier key with no wallet (two per network per day)

  • DELETE/v1/keys/current

    Revoke the key sent as x-api-key

Eyes
  • GET/v1/eyes/leaderboard

    This week and all time

  • GET/v1/eyes/seasonscount?

    Monthly seasons with leaders

  • GET/v1/eyes/bounties

    Investigation bounty board

  • GET/v1/eyes/profile/{address}address

    A contributor’s public record

  • GET/v1/eyes/claims

    Your payouts with on-chain receipts Signed-in wallet (Bearer session) or API key.

  • GET/v1/eyes/evidence/{address}address

    Observations from a token’s latest scan, to cite as evidence

  • POST/v1/eyes/report

    File a case report, a scanner miss or a false flag with cited observations Holder tier or above.

  • POST/v1/eyes/submit

    Submit to a Cyclops Eyes program Holder tier or above.

  • GET/v1/eyes/mine

    Your submissions Signed-in wallet (Bearer session) or API key.

  • GET/v1/eyes/prescreen

    Pre-screen queue (Sight rank and above) Holder tier or above.

  • POST/v1/eyes/prescreen/{id}id

    Pre-screen a report Holder tier or above.

  • GET/v1/eyes/appeals

    Public appeals log

  • POST/v1/eyes/appeals

    Appeal a label, flag, listing or decision Signed-in wallet (Bearer session) or API key.

  • GET/v1/bounties

    Open bounties

Rewards
  • GET/v1/rewards

    Rewards pool, burns and payouts

  • GET/v1/rewards/reserve

    Rewards reserve wallet and payout history

  • GET/v1/referrals/terms

    Referral rules and whether rewards are live

  • GET/v1/me/referral

    Your invite code, link and referral record Signed-in wallet (Bearer session) or API key.

  • POST/v1/referrals/claim

    Accept an invite as a new wallet Signed-in wallet (Bearer session) or API key.

  • GET/v1/me/credits

    Approved rewards awaiting payout and Pro time redeemed from them Signed-in wallet (Bearer session) or API key.

  • POST/v1/me/credits/redeem

    Take awaiting rewards as Pro time instead of tokens Signed-in wallet (Bearer session) or API key.

Community
  • GET/v1/roadmap/votes

    Roadmap votes

  • POST/v1/roadmap/votes/{item}item

    Vote for a roadmap item Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/roadmap/votes/{item}item

    Remove your vote Signed-in wallet (Bearer session) or API key.

  • GET/v1/requests

    Holder requests

  • POST/v1/requests

    Request something Holder tier or above.

Markets
  • GET/v1/record

    Call record

  • GET/v1/signals

    Open calls

  • GET/v1/calls/{id}id

    One call

  • GET/v1/feed.json

    Signed call feed

  • GET/v1/whales

    Large trades Holder tier or above.

  • GET/v1/wallet/{address}address

    Prediction-market wallet Pro tier.

Pre-launch
  • POST/v1/prelaunch/check

    Creator self-check before launch; ends in a “scanned” record, never a safety rating

  • POST/v1/partner/prelaunch

    The same check for launchpads, with an API key Signed-in wallet (Bearer session) or API key.

  • GET/v1/prelaunch/{id}id

    A stored pre-launch check

  • GET/v1/prelaunch/{id}/badge.svgid

    Badge for a pre-launch check (SVG)

x402
  • GET/v1/x402

    Pay-per-scan terms ({enabled:false} when off)

  • GET/v1/x402/scan/{address}address

    Token scan paid per request: 402 with requirements, then retry with X-PAYMENT

Trust
  • GET/v1/corrections

    Public corrections log with SLA performance

  • POST/v1/corrections

    Ask for a correction, a takedown or a privacy removal

Teams
  • GET/v1/me/teams

    Your teams, seats and roles Signed-in wallet (Bearer session) or API key.

  • POST/v1/teams

    Create a team (Holder: 1 team, Pro: 3) Holder tier or above.

  • GET/v1/teams/{id}id

    Members, open invites and investigated targets Signed-in wallet (Bearer session) or API key.

  • POST/v1/teams/{id}/invitesid

    One-use invite code for a seat (owner) Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/teams/{id}/invites/{code}id · code

    Withdraw an invite (owner) Signed-in wallet (Bearer session) or API key.

  • POST/v1/teams/join

    Join with an invite code Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/teams/{id}/members/{address}id · address

    Remove a member (owner) or leave Signed-in wallet (Bearer session) or API key.

  • GET/v1/teams/{id}/notesid · target?

    Shared notes, optionally for one target Signed-in wallet (Bearer session) or API key.

  • POST/v1/teams/{id}/notesid

    Add a shared note to an address or transaction Signed-in wallet (Bearer session) or API key.

  • DELETE/v1/teams/{id}/notes/{note}id · note

    Delete a note (author or owner) Signed-in wallet (Bearer session) or API key.