Skip to content

API reference

All endpoints answer GET with JSON, read only, with a key in the Authorization header. The API is in preview: keys open to Access members after legal review.

Illustration, generated with AI

value: a number, text, true, false or null as it is. text: text with every foreign Solana address replaced by "address hidden". []: a list, at most 200 entries. *: any key.

GET /api/v1/findings

Risk findings of one token: stage from the validated finding, each finding with evidence, measured weight (lift with range) and range. No 0-100 score.

Funding findings also carry funding_note: "A shared source does not prove a shared person."

Scope
findings
Parameters
mint=<token address>
Fields
52
FieldKind
rulevalue
mintvalue
symbolvalue
asOfvalue
viewvalue
stage.levelvalue
stage.whytext
stage.incompletevalue
stage.confidencevalue
stage.sourcetext
findings[].keyvalue
findings[].familyvalue
findings[].levelvalue
findings[].titletext
findings[].texttext
findings[].atvalue
findings[].candidatevalue
findings[].evidence.sourcevalue
findings[].evidence.kindvalue
findings[].evidence.rulevalue
findings[].evidence.confidencevalue
findings[].weight.statevalue
findings[].weight.rulevalue
findings[].weight.modelvalue
findings[].weight.clsvalue
findings[].weight.outcometext
findings[].weight.nvalue
findings[].weight.liftvalue
findings[].weight.ci[]value
findings[].weight.trainedAtvalue
findings[].weight.whytext
findings[].range.statevalue
findings[].range.whattext
findings[].range.lovalue
findings[].range.hivalue
findings[].range.methodtext
findings[].range.whytext
families.*.titletext
families.*.statevalue
families.*.nvalue
families.*.notes[]text
weights.rulevalue
weights.trainedAtvalue
weights.measuredvalue
weights.ofvalue
sim.rulevalue
sim.atvalue
sim.resultvalue
sim.causetext
sim.destKindvalue
notetext
fundingNotetext

GET /api/v1/evidence

Evidence of one entity: source named, time, evidence type, rule version, confidence, explanation. Never the raw answer of a provider.

Scope
evidence
Parameters
id=<entity id> or mint=<token address>
Fields
18
FieldKind
entity.idvalue
entity.kindvalue
entity.keyvalue
entity.labeltext
entity.first_seenvalue
entity.last_seenvalue
edgesvalue
quality.levelvalue
quality.atvalue
evidence[].evidence_idvalue
evidence[].finding_typevalue
evidence[].source_providervalue
evidence[].observed_atvalue
evidence[].evidence_typevalue
evidence[].confidencevalue
evidence[].calculation_versionvalue
evidence[].explanationtext
evidence[].statusvalue

GET /api/v1/forecasts

Forecast classes of one token. A probability only where the class beats the base rate on the holdout; otherwise state not_proven and p null.

Scope
forecasts
Parameters
mint=<token address>
Fields
18
FieldKind
mintvalue
trainedAtvalue
notetext
classes[].clsvalue
classes[].labeltext
classes[].groupvalue
classes[].rulevalue
classes[].horizonvalue
classes[].texttext
classes[].tvalue
classes[].duevalue
classes[].statevalue
classes[].pvalue
classes[].modelvalue
classes[].whytext
classes[].outcome.yvalue
classes[].outcome.tvalue
classes[].outcome.sourcevalue

GET /api/v1/investigations

Your own deep investigations: the last 20 without reports, or one with its report as members see it (no wallet addresses).

Scope
investigations
Parameters
none, or id=<investigation id>
Fields
33
AnswerFieldKind
investigations[].idvalue
investigations[].statusvalue
investigations[].created_atvalue
investigations[].finished_atvalue
investigations[].subject.mintvalue
investigations[].subject.symbolvalue
investigations[].subject.nametext
investigationidvalue
investigationstatusvalue
investigationcreated_atvalue
investigationfinished_atvalue
investigationreport.versionvalue
investigationreport.generated_atvalue
investigationreport.partialvalue
investigationreport.viewvalue
investigationreport.subject.mintvalue
investigationreport.subject.symbolvalue
investigationreport.subject.nametext
investigationreport.sections[].keyvalue
investigationreport.sections[].titletext
investigationreport.sections[].statusvalue
investigationreport.sections[].notetext
investigationreport.sections[].lines[].texttext
investigationreport.sections[].lines[].sourcevalue
investigationreport.sections[].lines[].evidence[]value
investigationreport.sources[].providervalue
investigationreport.sources[].nvalue
investigationreport.sources[].firstvalue
investigationreport.sources[].lastvalue
investigationreport.quality.levelvalue
investigationreport.quality.recordsvalue
investigationreport.quality.gapsvalue
investigationreport.notetext

GET /api/v1/entities

One entity with its edge and evidence counts, or a search. Kinds: token, launch, domain, github_repo, project, narrative, event, launchpad. Never wallets.

Scope
entities
Parameters
id=<entity id> or q=<text>
Fields
17
AnswerFieldKind
entitiesentity.idvalue
entitiesentity.kindvalue
entitiesentity.keyvalue
entitiesentity.labeltext
entitiesentity.first_seenvalue
entitiesentity.last_seenvalue
entitiesedgesvalue
entitiesquality.levelvalue
entitiesquality.atvalue
entitiesevidence_countvalue
entity_searchqvalue
entity_searchentities[].idvalue
entity_searchentities[].kindvalue
entity_searchentities[].keyvalue
entity_searchentities[].labeltext
entity_searchentities[].last_seenvalue
entity_searchentities[].matchvalue

Errors

400
Missing or malformed parameter.
401
No key, unknown key or revoked key.
403
The key lacks the scope, the owner has no Access, or the API is not open.
404
No such entity or investigation.
429
Monthly quota of the key used up, more than 60 calls in a minute, too many failed key checks, or the hub's day limit.
503
The hub or the database does not answer.