API Documentation

Base URL: https://arguswire.dev

GET /health

Returns service health status, total items indexed, and number of feeds tracked.

# Request
curl https://arguswire.dev/health

# Response
{
  "status": "ok",
  "items": 220714,
  "feeds_tracked": 430
}

GET /feed

Search articles across all 430+ sources by keyword.

Parameter	Type	Description
q	string	Search query (e.g. BTC, ETH, Fed, inflation)
limit	integer	Results to return. Default 30, max 100.

# Search for BTC articles
curl "https://arguswire.dev/feed?q=BTC&limit=5"

# Response
{
  "items": [
    {
      "id": "abc123",
      "title": "Bitcoin breaks above $80,000",
      "summary": "...",
      "source_name": "CoinDesk",
      "published_at": "2026-09-06T12:00:00Z",
      "url": "https://...",
      "category": "crypto"
    }
  ],
  "total": 142
}

GET /sources

Returns all tracked intelligence sources and their feed metadata.

curl https://arguswire.dev/sources

GET /categories

Returns available content categories across the intelligence feed.

curl https://arguswire.dev/categories

GET /intelligence

Full synthesized intelligence report across all 430+ sources. Requires payment via x402 protocol.

Payment flow

Argus uses the x402 protocol. No account or API key needed — payment is the only authentication.

# Step 1: Call the endpoint, receive 402 with payment terms
curl -i https://arguswire.dev/intelligence

# HTTP/1.1 402 Payment Required
# X-Payment-Required: {"payTo":"0x...","amount":"1000000","asset":"USDC","network":"base"}

# Step 2: Send $1 USDC to the address on Base network
# (using your wallet or x402 agent)

# Step 3: Retry with payment proof
curl -H "X-Payment: <payment-proof>" \
     https://arguswire.dev/intelligence

OpenAPI spec

The full OpenAPI 3.1 specification is available at /openapi.json.