{
  "name": "gitbeacon",
  "description": "gitBeacon — GitHub trend intelligence for AI agents. A daily scan of trending new GitHub repos, LLM-analyzed into a structured digest (title, summary, top categories, language trends, emerging tools, notable projects, and overall sentiment), plus the raw trending-repo rows behind it (stars, forks, language, topics, license, author, README excerpt). Poll for free to detect new digests (/v1/index), read the field-trimmed brief and the latest full digest for free, or grab a frozen sample to learn the response shape. Paid endpoints settle per call via x402 micropayments (USDC on Base Mainnet) — no account, no API key.",
  "url": "https://api.gitbeacon.dev",
  "provider": {
    "organization": "gitBeacon API",
    "url": "https://api.gitbeacon.dev"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "endpoints": [
    {
      "method": "GET",
      "path": "/v1/brief",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 10/min per IP). Field-trimmed snapshot of the current daily GitHub digest — title, summary, top categories, language trends, overall sentiment, and digestDate. Full digest at GET /v1/digests/latest (free)."
    },
    {
      "method": "GET",
      "path": "/v1/index",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 10/min per IP). Poll target — returns the current digest id, digestDate, and updatedAt plus the nextExpected time (24h cadence), so agents detect new digests without paying."
    },
    {
      "method": "GET",
      "path": "/v1/sample",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP). A FROZEN sample digest captured from the 2026-02-13 scan — the same shape as a real digest, but it never changes. Use it to learn the response contract before paying."
    },
    {
      "method": "GET",
      "path": "/v1/digests/latest",
      "params": [],
      "priceUsd": 0,
      "description": "Free (rate-limited 5/min per IP). The most recent completed daily GitHub digest with full fields: fullAnalysis, notableProjects, emergingTools, language trends, and volume metrics."
    },
    {
      "method": "GET",
      "path": "/v1/repos",
      "params": [
        "limit",
        "language"
      ],
      "priceUsd": 0.01,
      "description": "Paid ($0.01 USDC via x402). Top trending GitHub repos from the latest daily scan, sorted by stars — description, language, topics, license, forks, author followers, and README excerpt. Filterable by programming language. Response carries the scanDate provenance. Compute-first / settle-after — you are never charged for an error."
    },
    {
      "method": "GET",
      "path": "/v1/digests",
      "params": [
        "days",
        "limit"
      ],
      "priceUsd": 0.05,
      "description": "Paid ($0.05 USDC via x402). Historical daily GitHub digests (1-30 day lookback). Track how open-source trends, language popularity, and emerging tools evolve over time — each digest carries the same rich analysis as /v1/digests/latest, keyed by digestDate provenance. Compute-first / settle-after — you are never charged for an error."
    }
  ],
  "x402": {
    "version": 2,
    "networks": [
      "eip155:8453"
    ],
    "assets": [
      "USDC"
    ]
  },
  "skills": [
    {
      "id": "repos",
      "name": "Top trending repos",
      "description": "Paid ($0.01 USDC via x402). Top trending GitHub repos from the latest daily scan, sorted by stars — description, language, topics, license, forks, author followers, and README excerpt. Filterable by programming language. Response carries the scanDate provenance. Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.01,
      "tags": [
        "gitbeacon",
        "repos"
      ]
    },
    {
      "id": "digests",
      "name": "Historical GitHub digests",
      "description": "Paid ($0.05 USDC via x402). Historical daily GitHub digests (1-30 day lookback). Track how open-source trends, language popularity, and emerging tools evolve over time — each digest carries the same rich analysis as /v1/digests/latest, keyed by digestDate provenance. Compute-first / settle-after — you are never charged for an error.",
      "priceUsd": 0.05,
      "tags": [
        "gitbeacon",
        "digests"
      ]
    }
  ],
  "authentication": {
    "schemes": [
      "none",
      "x402"
    ],
    "description": "Free endpoints need no auth. Paid endpoints use the x402 V2 HTTP-402 flow: on an unpaid request the server returns a 402 whose accepts[] lists an exact USDC rail per network. Sign one rail and retry with the PAYMENT-SIGNATURE header (x402 V2) or legacy X-PAYMENT header. Per-call pricing."
  },
  "documentationUrl": "https://api.gitbeacon.dev/llms.txt",
  "openApiUrl": "https://api.gitbeacon.dev/openapi.json",
  "termsOfService": "https://api.gitbeacon.dev/terms.txt"
}
