Skip to content

Getting started

Quickstart

Create a key, run an analysis, and read the result — three requests, no SDK to install.

Everything here is plain HTTP. There is no package to install and no client to keep in sync.

1. Get a key

Analyses cost real inference credit, so they are metered. Creating a key needs no account and no payment details.

curl
curl -X POST https://api.molthood.org/api/v1/keys \
  -H "content-type: application/json" \
  -d '{"label": "my first key"}'
response
{
  "key": "mk_live_...",
  "hint": "mk_live_ab…",
  "label": "my first key",
  "daily_quota": 50,
  "note": "Store this now. It is not recoverable."
}

2. Run an analysis

curl
curl https://api.molthood.org/api/v1/token/0x5fc5360d04… \
  -H "Authorization: Bearer mk_live_..."

A token analysis takes roughly eight seconds. Wallets and contracts take longer because they make more upstream calls — see Limits.

3. Read the result

The response is the same shape for every target. The fields that matter most on a first read:

evidence[]
The findings. Each has a state of confirmed, refuted, or unknown, and a source_url you can open.
facts.risk
The score and level, plus the signals that produced them. Higher is safer.
summary
Model-written prose. summary_status says whether it was generated, skipped, or never configured.
sources[]
Every place the run read from, with links.
execution_id
Stable. Fetch it again later, or compare against it to see what changed.

Next