Fund your account with USDC or native SOL on Solana, prove ownership of the sending wallet, and spend prepaid credits one query at a time. Both assets are supported for new accounts and ongoing top-ups.
Ask about a wallet (or a mint, and we resolve its deployer): every recorded launch in the requested time window, each with launchpad, slot, dev-buy flag, observed metric flags and their count. Flags describe evidence, not a fraud probability. Responses include the observation period, coverage limitations and pagination. An unseen wallet has no records in that period; it is not certified safe.
Point it at any mint and get the live on-chain read: mint and freeze authorities, sampled holder concentration with unresolved ownership made explicit, metadata signals, retained capture manifests, and recorded launch provenance. Built for humans; free for everyone.
Everything here is observation of public chain data. It is not financial advice, and it is not a signal service — the endpoints return facts, never a recommendation.
Use the free query example below. There is no authentication requirement for dossier queries during this window. Account-specific operations, including reading your balance and claiming an optional deposit, still require their existing ownership proofs.
All public API data is free during this window. No API key, wallet connection or deposit is needed for queries. Existing account credits stay untouched.
curl -X POST https://nousprotocol.org/api/v1/query \
-H 'content-type: application/json' \
-d '{"mint":"4RngpYCuoVsRLcUXrV4rXD7Ae2yGLiNf7TST4tNLpump","window":"all","limit":10}'
Fair-use limits: 60 free queries per minute per IP, with a shared 600-per-minute service limit. Follow Retry-After if you receive 429. Standard prepaid query billing returns automatically when the window ends.
Deposits are optional credit top-ups for future use. Standard billing guide ↗
The endpoint answers 402 Payment Required with the treasury, accepted assets and deposit instructions. USDC is the default; native SOL is also accepted. Nous prepaid billing (nous-prepaid-v1) provides x402-style discovery; standard x402 payment-header settlement is not implemented.
curl -X POST https://nousprotocol.org/api/v1/deposits
Transfer to the treasury below from a wallet your agent controls. A minimum deposit of $1 USDC or 0.01 SOL buys 50 credits. Keep enough SOL in the sending wallet to cover network fees.
| Asset | Per credit | Minimum deposit |
|---|---|---|
| USDC (default) | $0.02 USDC | $1 USDC |
| Native SOL | 0.0002 SOL (200,000 lamports) | 0.01 SOL (10,000,000 lamports) |
The SOL price is a fixed tariff, not a USD exchange quote. Both assets fund the same query credits. Use one payment asset per transaction: a transaction can be credited only once. Native SOL deposits use a direct System Program transfer; wrapped SOL is not accepted as native SOL.
2XGJ8X6WagK6LuUAjPkRh7bPwoP6dd9jhEZLRM7ZhwPt
USDC mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v · Solana mainnet.
Wait for the transfer to finalize, then request a challenge using its transaction signature and the sending wallet address. Include "asset":"SOL" for a native SOL deposit; omitting asset selects USDC. Sign the returned message exactly as UTF-8 bytes with that wallet.
curl -X POST https://nousprotocol.org/api/v1/deposits/challenge \
-H 'content-type: application/json' \
-d '{"signature":"<transfer signature>","wallet":"<sender wallet>","asset":"SOL"}'
Send the signed challenge back. walletSignature is the Ed25519 signature encoded as base58 or base64. Store the API key securely. To top up an existing account, include its bearer key in both calls.
curl -X POST https://nousprotocol.org/api/v1/deposits/confirm \
-H 'content-type: application/json' \
-d '{"challengeId":"<challenge id>","signature":"<transfer signature>","wallet":"<sender wallet>","walletSignature":"<signed message>"}'
{ "ok": true, "apiKey": "nous_…", "credited": 50, "balanceCredits": 50 }
If the confirmation response is lost, retry with the same challengeId and signed proof to recover the result without crediting the transfer twice. Keep that request until confirmation succeeds; a new challenge cannot reclaim an already credited transfer. The receipt's balanceCredits is its original snapshot; use GET /api/v1/balance for the current balance.
Send the key as a bearer token. One credit for the initial page of a query; continuation pages using its cursor are free; the balance and cost come back with every response so your agent can budget without a second call.
curl -X POST https://nousprotocol.org/api/v1/query \
-H 'authorization: Bearer nous_…' \
-H 'content-type: application/json' \
-d '{"deployer":"<wallet address>"}'
After any free-access window ends, when a balance hits zero the query endpoint answers 402 with the same payment requirements as step one, so a paying agent can top itself up and carry on without human help.
| Endpoint | What it does | Cost |
|---|---|---|
GET /api/v1/pricing |
Terms, treasury, window size and current serving status, as JSON. | Free |
GET /api/v1/analyze?q=<mint> |
Single-token analysis: authorities, holder concentration, unresolved ownership, metadata signals, launch provenance and flags. Pool attribution is reported as unknown. | Free |
POST /api/v1/deposits |
Returns 402 with custom prepaid deposit requirements. |
Free |
POST /api/v1/deposits/challenge |
Creates a short-lived message bound to your transfer, asset, wallet and account. Use asset: "SOL" for native SOL; USDC is the default. |
Free |
POST /api/v1/deposits/confirm |
Verifies wallet ownership and a finalized transfer in the challenge's asset, then credits the account exactly once. Returns the API key on first deposit. | Free |
GET /api/v1/balance |
Remaining credits and nominal USD credit value ($0.02 per credit). This is not the market value of deposited SOL. Bearer key required. | Free |
POST /api/v1/query |
Deployer dossier for a wallet or mint. Bearer key required. | 1 credit |
GET /.well-known/x402 |
Machine-readable deposit instructions. Custom prepaid flow; not a standard x402 facilitator integration. | Free |
GET /api/v1/tokenomics |
Public token identity status, customer receipt coverage, per-asset allocations and verified purchase/burn totals. Amounts use decimal strings of atomic units: lamports for SOL and micro-units for USDC. No currency conversion is implied. | Free |
GET /api/v1/buybacks?limit=10 |
Read-only manual batch records with individual purchase, conversion and burn proof states. Follow a non-null nextCursor with cursor; limit defaults to 10 and is capped at 50. A pending record is not a completed purchase or burn. |
Free |
GET /api/events |
A capped recent-event viewport with source freshness. Query history is stored separately and does not depend on this buffer. | Free |
100% of verified Nous API customer payments are allocated to manual token buybacks and burns, including execution fees. Operating costs are funded separately. There is no fixed execution schedule. Historical customer payments are included; internal tests such as Scout, creator fees, donations and unrelated transfers are excluded.
The public token tracker shows the current token identity verification status, verified mint details, receipt coverage, asset allocations and transaction verification states. Token details appear only after identity verification. These public endpoints require no API key and do not spend credits.
Queries default to the last six hours of recorded Pump.fun, Meteora DBC and Raydium LaunchLab launches. Send "window":"all" for all collected history. Records persist independently of the terminal buffer. A returned cursor fetches the next page without another charge. Capture started recently and has known gaps: this is observed history, not a complete chain archive. The response states coverage and its as-of time.
Watch it work, for free and without an account, on the terminal — recent recorded launches and flags appear with their original timestamps. The badge reports whether chain data is advancing.