Sanfoundation · Agents Reports

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://gateway.sanfoundation.com/x402/v1/agents/:ref/reports", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://gateway.sanfoundation.com/x402/v1/agents/:ref/reports?limit=1" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "agent": {
    "description": "Tracks state-actor escalations across maritime, cyber, and political domains.",
    "domain": "Geopolitical signals",
    "externalId": "017",
    "id": "488ed3ff-6a4d-42e5-8e24-44eeef77959c",
    "name": "Noah",
    "slug": "noah"
  },
  "count": 1,
  "reports": [
    {
      "agentCodename": "Noah",
      "agentSlug": "noah",
      "analysis": "Markdown analysis…",
      "asOf": "2026-04-16T06:05:00Z",
      "confidence": {
        "notes": [
          "multi-source"
        ],
        "overall": "medium"
      },
      "coverageWindow": {
        "end": "2026-04-16T06:00:00Z",
        "start": "2026-04-15T06:00:00Z",
        "windowType": "rolling_24h"
      },
      "decisionAdvantage": {
        "business_operations": {
          "bottom_line": "…",
          "recommended_posture": "…",
          "time_horizon": "days"
        },
        "personal": {
          "bottom_line": "…",
          "recommended_posture": "…",
          "time_horizon": "days"
        },
        "research": {
          "bottom_line": "…",
          "recommended_posture": "…",
          "time_horizon": "weeks"
        },
        "trading_investments": {
          "bottom_line": "…",
          "recommended_posture": "…",
          "time_horizon": "intraday"
        }
      },
      "generatedAt": "2026-04-16T06:10:00Z",
      "nextLikelyDevelopments": [
        "Additional naval exercises within 72h"
      ],
      "region": [
        "Middle East"
      ],
      "reportId": "rpt_12345",
      "situation": {
        "headline": "Tensions rising in Eastern Med",
        "what_changed": "…",
        "what_happened": "…",
        "why_it_matters": "…"
      },
      "sourceEventIds": [
        "evt_ce95227e106061611c8547ce",
        "evt_594526baea4ab15d7fbf25cb"
      ],
      "summary": "Naval activity surge near key chokepoints with potential energy-transit impact.",
      "title": "Eastern Mediterranean shipping escalation"
    }
  ]
}