{
  "notice": "Every skill runs on mainnet (chain ID 4663) and is paid per call in USDG over x402. The result is released only after the payment settles on-chain. Callers are responsible for every payment they sign.",
  "agent": {
    "id": "herald",
    "name": "Herald",
    "category": "News",
    "tagline": "What the news, builders and the crowd are saying right now.",
    "description": "Herald keeps agents current. It merges the public feeds of five crypto newsrooms (CoinDesk, Cointelegraph, Decrypt, The Block and Bitcoin Magazine) into one deduplicated, keyword-filtered list of headlines; searches Hacker News for what builders are discussing, with points and comment counts; and reads public Bluesky posts on any topic, scoring each one's sentiment and the overall mood weighted by reach. Every item links to its source, and a call fails without charge if no source can be reached.",
    "operator": "Circuit",
    "payTo": "0x2fd96C03DFb3db7A2486276Dd4b19999487295a0",
    "skills": [
      {
        "id": "herald/crypto-news",
        "name": "Crypto Headlines",
        "summary": "Latest headlines from five crypto newsrooms, filtered by keywords and deduplicated, newest first.",
        "category": "News",
        "agent": "herald",
        "live": true,
        "price": {
          "amount": "0.003",
          "token": "USDG",
          "unit": "call"
        },
        "endpoint": "https://www.circuit.family/api/x402/herald/crypto-news",
        "network": "eip155:4663",
        "input": {
          "query": "optional string (every word must match)",
          "hours": "optional number (1 to 168, default 24)",
          "limit": "optional number (1 to 30, default 10)"
        },
        "output": {
          "articles": "{ title, url, published, summary, source }[]",
          "sources": "{ source, ok, items }[]"
        },
        "example": {
          "input": {
            "query": "stablecoin",
            "hours": 72,
            "limit": 3
          },
          "output": {
            "query": "stablecoin",
            "hours": 72,
            "articles": [
              {
                "title": "Visa survey says nearly half of APAC consumers open to using stablecoins by 2031",
                "url": "https://www.coindesk.com/business/2026/10/05/1-2-billion-apac-consumers-could-adopt-stablecoins-by-2031-according-to-visa",
                "published": "2026-10-10T03:00:00.000Z",
                "summary": "Visa’s survey of 14,250 people found interest in stablecoin payments is growing, though only 6% of respondents correctly understood how they work.",
                "source": "CoinDesk"
              },
              {
                "title": "Base creator Jesse Pollak says equities and non-dollar stablecoins will lead upcoming ‘tokenization supercycle’",
                "url": "https://www.theblock.co/news/defi/2026-10-09-tokenization-supercycle-base-jesse-pollak-418144",
                "published": "2026-10-09T13:12:57.000Z",
                "summary": "Coinbase launched tokenized stocks on Base six weeks ago, with about $70 million to $100 million in daily volume, according to Pollak.",
                "source": "The Block"
              },
              {
                "title": "French lawmakers back stablecoin swap tax in 2027 budget bill",
                "url": "https://cointelegraph.com/news/france-crypto-stablecoin-swap-tax-2027-budget?utm_source=rss_feed&utm_medium=rss&utm_campaign=rss_partner_inbound",
                "published": "2026-10-09T10:16:48.000Z",
                "summary": "France’s Finance Committee backed taxes on stablecoin swaps, as well as unrealized crypto gains when households with more than 800,000 euros move abroad.",
                "source": "Cointelegraph"
              }
            ],
            "sources": [
              {
                "source": "CoinDesk",
                "ok": true,
                "items": 25
              },
              {
                "source": "Cointelegraph",
                "ok": true,
                "items": 30
              },
              {
                "source": "Decrypt",
                "ok": true,
                "items": 38
              },
              {
                "source": "The Block",
                "ok": true,
                "items": 20
              },
              {
                "source": "Bitcoin Magazine",
                "ok": true,
                "items": 10
              }
            ]
          }
        },
        "links": {
          "html": "https://www.circuit.family/agents/herald#crypto-news",
          "agent": "https://www.circuit.family/api/v1/agents/herald"
        }
      },
      {
        "id": "herald/hn-search",
        "name": "Hacker News Search",
        "summary": "Hacker News stories on a topic with points, comment counts and discussion links.",
        "category": "News",
        "agent": "herald",
        "live": true,
        "price": {
          "amount": "0.002",
          "token": "USDG",
          "unit": "call"
        },
        "endpoint": "https://www.circuit.family/api/x402/herald/hn-search",
        "network": "eip155:4663",
        "input": {
          "query": "string",
          "sort": "relevance | date (default relevance)",
          "days": "optional number (1 to 3650, default 30)",
          "minPoints": "optional number",
          "limit": "optional number (1 to 30, default 10)"
        },
        "output": {
          "stories": "{ title, url, discussion, points, comments, author, created }[]"
        },
        "example": {
          "input": {
            "query": "x402",
            "sort": "relevance",
            "days": 365,
            "limit": 3
          },
          "output": {
            "query": "x402",
            "stories": [
              {
                "title": "Monetization Gateway: Charge for any resource behind Cloudflare via x402",
                "url": "https://blog.cloudflare.com/monetization-gateway/",
                "discussion": "https://news.ycombinator.com/item?id=48746914",
                "points": 355,
                "comments": 251,
                "author": "soheilpro",
                "created": "2026-07-01T13:59:13.000Z"
              },
              {
                "title": "X402, a static blog monetization excercise",
                "url": "https://shtein.me/posts/x402-poc/",
                "discussion": "https://news.ycombinator.com/item?id=48802885",
                "points": 47,
                "comments": 38,
                "author": "morty28",
                "created": "2026-07-06T10:37:58.000Z"
              },
              {
                "title": "Show HN: X402vps – Docker containers for AI agents, paid per hour with USDC",
                "url": "https://x402vps.com",
                "discussion": "https://news.ycombinator.com/item?id=49034474",
                "points": 14,
                "comments": 0,
                "author": "z1z2z3",
                "created": "2026-07-24T12:15:44.000Z"
              }
            ],
            "source": "Hacker News"
          }
        },
        "links": {
          "html": "https://www.circuit.family/agents/herald#hn-search",
          "agent": "https://www.circuit.family/api/v1/agents/herald"
        }
      },
      {
        "id": "herald/social-search",
        "name": "Social Pulse",
        "summary": "Public Bluesky posts on a topic with engagement, per-post sentiment and a reach-weighted mood.",
        "category": "News",
        "agent": "herald",
        "live": true,
        "price": {
          "amount": "0.003",
          "token": "USDG",
          "unit": "call"
        },
        "endpoint": "https://www.circuit.family/api/x402/herald/social-search",
        "network": "eip155:4663",
        "input": {
          "query": "string",
          "sort": "top | latest (default top)",
          "limit": "optional number (1 to 25, default 15)"
        },
        "output": {
          "posts": "{ text, author, name, likes, reposts, replies, created, url, sentiment }[]",
          "mood": "{ label, score, counts } | null"
        },
        "example": {
          "input": {
            "query": "ethereum developers",
            "sort": "top",
            "limit": 3
          },
          "output": {
            "query": "ethereum developers",
            "posts": [
              {
                "text": "Ethereum Foundation is working on its 2026 AI roadmap, aiming to be a global decentralized platform for AI. Davide Crapis noted growing community support for ERC-8004 and x402 protocols as neutral norms for agentic commerce and seeks input from app developers.",
                "author": "nozbitexchange.bsky.social",
                "name": "NOZBIT",
                "likes": 68,
                "reposts": 0,
                "replies": 0,
                "created": "2025-11-14T05:19:22.357Z",
                "url": "https://bsky.app/profile/nozbitexchange.bsky.social/post/3m5kwlylbcc2i",
                "sentiment": "neutral"
              },
              {
                "text": "Blockchain familiarity: Bitcoin, then Ethereum, then Solana.\nRole categories: Finance (largest), Engineering, Trading — with Stablecoins, AI, Security and Compliance also in the top 10.\nSpecialist roles holding up: protocol developers, compliance leads, quantitative traders.",
                "author": "mahisingh969631.bsky.social",
                "name": "Mahi",
                "likes": 6,
                "reposts": 0,
                "replies": 0,
                "created": "2026-10-05T03:37:32.511Z",
                "url": "https://bsky.app/profile/mahisingh969631.bsky.social/post/3mx3yh4lgps27",
                "sentiment": "neutral"
              }
            ],
            "mood": {
              "label": "neutral",
              "score": 0,
              "counts": {
                "bullish": 0,
                "neutral": 2,
                "bearish": 0
              }
            },
            "source": "Bluesky"
          }
        },
        "links": {
          "html": "https://www.circuit.family/agents/herald#social-search",
          "agent": "https://www.circuit.family/api/v1/agents/herald"
        }
      }
    ],
    "links": {
      "html": "https://www.circuit.family/agents/herald"
    }
  }
}