# KARP Agents API by SoulDriver > Research answers and live fact-checks for AI agents, from KARP, SoulDriver's multi-model research engine (GPT, Gemini, Grok and Claude). Pay per call with x402 (USDC on Base or Solana); no account or API key. Base URL: https://agents.souldriver.com.au ## How to use KARP 1. Send the question you are actually researching to the free POST /v1/coverage, as a full question in plain words. A placeholder such as "test" tells you nothing about the library. 2. covered: call POST /v1/ask with the same question for the research cards. 3. partial: related research exists. /v1/ask returns it; check that the card topics and dates fit your question. 4. none: KARP has not researched it. To verify one factual claim, use POST /v1/check. 5. No wallet yet? POST /v1/grant with what your agent researches and 1-3 real questions: a free research grant gives 25 asks and 2 fact-checks; send its key as the x-karp-grant header. 6. Add "intent" (what you are trying to find out, and why) to coverage and ask: it helps decide what KARP researches next. 7. Cards older than 180 days are flagged stale: verify time-sensitive figures with POST /v1/check. Example: `POST /v1/coverage` `{"query":"Do GLP-1 drugs help prevent Alzheimer's, and does APOE4 status change the answer?"}` ## What KARP has researched Deepest on: - Alzheimer's disease and neurodegeneration (GLP-1 drugs, APOE4, ferroptosis) - the biology of ageing and circadian rhythms - ancient scripts and measurement systems (Indus script, Inca khipu) - AI regulation and governance (EU AI Act) - quantum computing Plus individual studies on many other subjects. `/v1/coverage` is the reliable test for any one question. ## Endpoints 1. `POST /v1/coverage` `{"query": "your research question"}`: free. Says whether KARP has research on it (covered, partial or none), the match strength, the newest research date, matching titles and which endpoint to call next. Use it first. 2. `POST /v1/grant` `{"agent":"","builder":"","purpose":"","questions":["",""]}`: free, for agents without a wallet. Fill in every <...> with your own details. A key for 25 asks and 2 fact-checks (30 days), plus KARP's coverage of your questions. Send it as the `x-karp-grant` header on /v1/ask and /v1/check. Copies of examples, or of this template, are refused. One grant per client every 7 days. Terms, read-only and free: `GET /v1/grant`. 3. `POST /v1/ask` `{"query": "...", "max_cards": 1-8}`: $0.03. Research cards from KARP's library of past multi-model debates: conclusion, key insight, warnings, dated figures, consensus, open questions. Every card carries its research date and a stale flag, so check how current it is. Usually 5-15 s, including payment. 4. `POST /v1/check` `{"claim": "..."}`: $0.25. Hallucination check: one claim fact-checked live by four models, each searching the web separately. Returns the verdict (confirmed, disputed, unverifiable, or contested when they split), agreement such as 4/4, mean confidence, a one-line headline, then each model's reasoning and sources. 10-45 s. ## Paying - An unpaid request gets HTTP 402 with the payment requirements in the `PAYMENT-REQUIRED` header (x402 v2). Sign a USDC payment and retry with the `PAYMENT-SIGNATURE` header. Any x402 client works, for example `@x402/fetch` or Coinbase Payments MCP. - Networks: Base or Solana (USDC). - The payment is settled only when the call succeeds. If it fails, nothing is charged. - One payment pays for one request. - No wallet yet? A research grant (`POST /v1/grant`) pays instead while it lasts: send its key as the `x-karp-grant` header. When it runs out, the normal 402 applies. ## Limits - A query or claim is up to 500 characters; the JSON body up to 8 KB. - 120 requests per minute per client; /v1/coverage 20 per minute. ## Links - [OpenAPI](https://agents.souldriver.com.au/openapi.json): endpoints, request schemas and prices, machine-readable - [Catalogue](https://agents.souldriver.com.au/): the same summary as JSON - [SoulDriver](https://souldriver.com.au): who runs KARP