Gate

Base URL: https://api.codespar.dev

Every operation below requires a Bearer token. See Authentication.

GET /v1/gate/stats

Gate earnings and 402 conversion for the project

Everything the project sells through gw.codespar.dev in one read: its paywalls and the tools of its MCP servers, over the last 30 Sao Paulo calendar days including today. Scope paywalls:read, and mcp-servers:read as well, checked by the handler because the body carries the MCP tools: a key without it gets the same 403 forbidden the scope gate sends.

Earnings, paid calls and paying agents are aggregated at read time from the settlement evidence, with the attribution rule GET /v1/paywalls/{id}/stats uses; x402 settlements only. A sale of an item deleted since still counts toward the totals and has no row in items.

earnings_atomic is what the seller kept: net of metered refunds and of the MCP platform fee recorded on each sale; gross_earnings_atomic is before the fee.

challenges_issued, payment_attempts and challenges_paid come from a per-day counter the gateway keeps. The conversion is challenges_paid / payment_attempts, at most 100% by construction: every settle is counted on the row of its own attempt. No ratio should be built on challenges_issued, since a client that knows the terms pays without receiving a 402.

Query parameters

Responses

Response 200

curl -X GET https://api.codespar.dev/v1/gate/stats \
  -H "Authorization: Bearer $CODESPAR_API_KEY"

GET /v1/gate/stats HTTP/1.1
Host: api.codespar.dev
Authorization: Bearer $CODESPAR_API_KEY

import os
import requests

res = requests.get(
    "https://api.codespar.dev/v1/gate/stats",
    headers={"Authorization": f"Bearer {os.environ['CODESPAR_API_KEY']}"},
)
res.raise_for_status()
data = res.json()

const res = await fetch("https://api.codespar.dev/v1/gate/stats", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.CODESPAR_API_KEY}`,
  },
});

const data = await res.json();

const result = await cs.api.get("/v1/gate/stats");

{
  "window": "30d",
  "from": "2026-01-15T12:00:00.000Z",
  "to": "2026-01-15T12:00:00.000Z",
  "earnings_atomic": "string",
  "gross_earnings_atomic": "string",
  "previous_earnings_atomic": "string",
  "paid_calls": 0,
  "published_links": 0,
  "paying_agents": 0,
  "new_paying_agents_this_month": 0,
  "challenges_issued": 0,
  "payment_attempts": 0,
  "challenges_paid": 0,
  "items": [
    {
      "kind": "paywall",
      "id": "obj_0000000000000000",
      "tool_name": "Example",
      "paid_calls_24h": 0,
      "earnings_atomic": "string",
      "gross_earnings_atomic": "string"
    }
  ]
}