API

A launch record, as JSON

Every record on this site is also a JSON document, served to API keys. Send the key as Authorization: Bearer <key>. Plans and enterprise agreements. /api/v1/status stays open, and so does every token page on this site.

There is one thing you have to get right, and it is the next section.

The field to branch on is finding.class, which is one of FINDINGS, NOTE, NO_MARKERS or UNKNOWN. These name classes of entry on a record, not grades of risk and not advice. We record what a launch was; what that is worth is yours to decide. Read them as:

cleanAtBirth is a convenience and it has three states, not two:

Once a token's float has been spread across wallets, a launch that was assembled and one that was not look the same to present-tense inspection, and that is the entire reason this archive exists. A null means the evidence is gone, which is the opposite of reassuring. Every refusal and every error we return also carries finding.class = "UNKNOWN", so code that reads only that field is safe even when it ignores the HTTP status.

curl -H "Authorization: Bearer $COT_KEY" https://chainoftitle.org/api/v1/token/<mint>

Coverage begins 2026-09-02 12:29 UTC. Ask for an older launch and we reconstruct it from the bonding curve's complete transaction history: thousands of archival RPC reads, which is a background job, not a request. You get 202 with finding.class = "UNKNOWN" and a rebuild object; poll the same URL. A finished record is permanent, so the second call is usually the last one you ever make for that mint.

Reads are metered per key per UTC day, by plan. Rebuilds cost real money, so each caller can start 5 an hour and the service has a daily ceiling. When that is reached you get 503 rebuild_budget_exhausted: the archive is unaffected, only new reconstruction is paused. Bulk historical reconstruction is available under a data agreement: hello@chainoftitle.org.

10,000 requests a day, the JSON launch record for any mint we hold, reconstruction of launches we did not watch, and the current record database as one file. Checkout is Stripe's; the key is emailed once and stored only as a hash. Sustained volume past 10,000 requests a day, the creation feed, or bulk historical reconstruction is a data agreement instead.

If you ship this in front of users and find a record you think is wrong, tell us: a wrong entry on a record costs more than a missing one. hello@chainoftitle.org

A real response from the current record - the clean-launch report's subject, refreshed as the record rebuilds. Keyed responses carry a license field beside this.

{
  "apiVersion": "v1",
  "coverage": {
    "from": {
      "ms": 1788352172581,
      "iso": "2026-09-02T12:29:32.581Z"
    },
    "downtimeMinutes": 46,
    "note": "Launches outside these windows were not observed. We rebuild them from chain history on request; until that succeeds their provenance is unknown, not clean."
  },
  "asOf": {
    "ms": 1789752644449,
    "iso": "2026-09-18T17:30:44.449Z"
  },
  "generatedAt": {
    "ms": 1789763071269,
    "iso": "2026-09-18T20:24:31.269Z"
  },
  "source": "https://chainoftitle.org/t/5NP3pTMgbvioJaki2Sdxm7DiaA2tt3BFkqTJyYNF5EwQ.html",
  "license": "Chain of Title data licence (https://chainoftitle.org/terms.html)",
  "mint": "5NP3pTMgbvioJaki2Sdxm7DiaA2tt3BFkqTJyYNF5EwQ",
  "symbol": "PurpDrop",
  "name": "PurpDrop",
  "venue": "pumpfun",
  "finding": {
    "class": "NO_MARKERS",
    "label": "Checked, no markers found",
    "why": "We watched this launch and checked it against every marker we record. None of them is present: the creator kept 1.7%, 428 outside wallets bought on the curve, the curve took longer than a minute to fill, and no single wallet took it. A statement about what we checked, not a judgement about the token."
  },
  "cleanAtBirth": true,
  "observedAtLaunch": true,
  "origin": "observed",
  "launch": {
    "createdAt": {
      "ms": 1788938126027,
      "iso": "2026-09-09T07:15:26.027Z"
    },
    "creator": "DM5MVrMMr3vCacySqn5szpqDJMaPQCnSanoLAh7G7gLR",
    "creatorSupplyPct": 1.737651816691,
    "creatorSold": false,
    "curveBuyers": 428,
    "buyersFirst30s": 4,
    "bundledBuyers": 0,
    "graduated": true,
    "graduationObserved": true,
    "graduationCheck": null,
    "graduationConfirmedBy": "pool",
    "graduatedAt": {
      "ms": 1788940589042,
      "iso": "2026-09-09T07:56:29.042Z"
    },
    "secondsToGraduate": 2463,
    "transaction": {
      "signature": "4oMx1fn65LhFchEcDTPiY9Y3X3R74VVhkvnXHrGPosiXQmaic7pmVvVMkkw1bFKacK7cSfEg8z4C5ztXNfcxmetF",
      "slot": 445551606
    }
  },
  "curveBuyout": null,
  "pool": null,
  "funder": {
    "sharedCohort": null
  },
  "flags": []
}