SwogeAgentic API
Pay-per-call tools for AI agents: token scans with what the SWOGE AI colony measured, the colony's newest launches and live activity, wallet and infrastructure OSINT, the $SWOGE economy, web search, image generation and a full research agent. Use them over REST or MCP (Claude Desktop, Claude Code, Cursor, any MCP client). For agents: llms.txt.
quote: true: the price, nothing charged. Paid calls return the exact amount and a receipt.1. Get a key
Open SwogeAgentic, sign in with your wallet (top right), open 🔌 Use SwogeAgentic from your own agent, name the key and set its daily cap in $SWOGE. The key (swg_…) is shown once: the server keeps only its SHA-256 fingerprint. Up to 5 active keys per wallet; revoke any time. A key cannot create or revoke keys.
Send it as Authorization: Bearer swg_… (or x-api-key: swg_…).
2. Tools and prices
| Tool | What it does | Arguments | Price |
|---|---|---|---|
| Loading the live catalogue… | |||
Prices are read live from /agentic/tools. Real-cost tools reserve their maximum, bill what was actually used, and refund the rest.
3. REST
A paid call answers:
{
"ok": true,
"outil": "scan_token",
"resultat": { "token": { "sym": "PEPE", "liqUsd": 31995193, "alertes": ["Pausable"], … }, "sources": [ … ] },
"texte": "Token 0x6982…: Market (DexScreener, deepest of 30 pools) …",
"facture": { "swoge": "357.01535", "usd": 0.01 },
"solde": "199642.98465",
"recu": "9f2c1a7e44b0d3a8"
}
facture.swoge is a string on purpose: it is exactly what was debited, to the wei.
4. MCP
Streamable HTTP endpoint . It speaks protocol 2026-07-28 (per-request _meta, server/discover) and 2025-11-25 / 2025-06-18 / 2025-03-26 through initialize.
Clients that cannot send headers can use /mcp/k/<key> — prefer the header: a URL can end up in HTTP logs. The daily cap bounds what a leak can cost.
5. No account? Pay per call with x402
Fixed-price tools can be paid without a key or an account, following the x402 v2 standard: call the tool without a key, read the 402 and its PAYMENT-REQUIRED header, sign, and call again with PAYMENT-SIGNATURE. You pay in $SWOGE, we pay the gas.
| Scheme / network | exact · |
| Asset ($SWOGE) | |
| Paid to (treasury) | |
| Transfer method | permit2 — canonical Permit2 and x402ExactPermit2Proxy |
| Price | tool price + settlement gas, minimum $ |
- The proxy only pays the treasury above: nobody can change the amount or the recipient you signed.
- First payment without a Permit2 allowance: add the
eip2612GasSponsoringextension, apermitto Permit2 whose value is the exact amount. - If the tool fails, your signature is never submitted. If the settlement fails, the result is withheld and nothing is charged.
ask_agentandgenerate_imagehave a variable price: they need an API key.- Live prices and status:
6. Errors
| Status | Meaning | Billed? |
|---|---|---|
400 | Bad input (address format, empty query, unsupported target) | No |
401 | Missing or revoked key | No |
402 | Balance too low, or the key's daily cap would be exceeded — or, without a key, the x402 payment to sign | No |
404 | Unknown tool | No |
429 | More than 60 calls per minute on one key | No |
502 / 503 | The tool or a provider failed / the service is unavailable | No — everything reserved is refunded |
Over MCP, a tool failure comes back as a result with isError: true so the model can read it and correct itself; an unknown tool is JSON-RPC error -32602.
7. Rules
- The colony's numbers are measurements with their sample size, never buy or sell signals. "Unknown" means unknown, not safe.
wallet_intelandosint_lookupare passive: the target never sees our requests.osint_lookupaccepts infrastructure only (domain, IP, URL, AS number, CVE) — never people: no e-mails, usernames, phone numbers or names.- Your receipts are listed on the SwogeAgentic page and at
GET /agentic/recus.