Carbon-Aware API

Developer tools — pay-per-call in USDC · Swagger docs

Endpoints

EndpointDescriptionCredits
POST /v1/keys/registerCreate your API key (free)
GET /v1/credits/balanceCheck remaining credits
GET /v1/carbon-intensityReal-time gCO₂eq/kWh — zones GB, FR1 cr
POST /v1/webhook/transformJinja2 template transform + optional forward1 cr
POST /v1/fake/generateSynthetic test data via Faker (6 locales)1 cr
GET /v1/oracle/{asset}Crypto price USD+EUR+24h change (BTC, ETH, MATIC…)2 cr
GET /v1/oracle/gas/{chain}Gas price in Gwei — Polygon or Ethereum2 cr
POST /v1/chain/gateVerify ERC20/ERC721/ERC1155 balance on Polygon3 cr
POST /v1/prompt/guardPrompt injection detector (11 patterns + Mistral)5 cr
POST /v1/text/anonymizePII detector/redactor — RGPD compliant8 cr
POST /v1/review/codeAI code review — issues, score, recommendations10 cr
POST /v1/debug/explainStack trace explainer — root cause + fix10 cr
POST /v1/llm/completeGeneric LLM completion via Mistral (prompt or chat)1 cr/100 tok
POST /v1/pdf/extractPDF → structured JSON (invoice, CV, table, raw)20 cr

Getting started

1
Register — get your API key instantly, no account needed
curl -X POST https://carbon.norm.ovh/v1/keys/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'
2
Buy credits — send USDC, USDT, or MATIC/POL on Polygon, email your tx hash
1 USDC = 200 credits · wallet: 0x11bF0A45d5228A48Fb29460f10Eb50Cf49205196
Then email sofia.luz@norm.ovh with your tx hash + api_key — our bot credits your account automatically
3
Call any tool — pass your key in the X-API-Key header
curl https://carbon.norm.ovh/v1/oracle/ETH \
  -H "X-API-Key: sk-ca-..."