# StablecoinPulse

> Real-time stablecoin market intelligence API. GENIUS Act compliance reads, yield comparison, peg-stability monitoring, cross-chain flow tracking, payment-rail comparison (Plasma/Arc/Tempo/Stable vs Tron/Solana/Base), reserve-attestation freshness, and global regulatory status (MiCA, Japan, Singapore, UK, Hong Kong, UAE, and more) — all via x402 micropayments on Base. Global audience from day one.

## What This Is

StablecoinPulse is a pay-per-query API that synthesizes live stablecoin market data, US federal
rulemaking dockets, and real-time news into structured, actionable intelligence for compliance
teams, treasury managers, DeFi allocators, and AI agents.

Deterministic math (peg deviation, cross-chain flows, market aggregates) is computed server-side
and never invented by the model. Claude is used only to narrate already-verified data or to
synthesize compliance/regulatory reads from real search results and Federal Register documents —
every response documents its sources.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with
payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

GET /api/issuer-check?issuer={name}|stablecoin={ticker}
- Returns: GENIUS Act compliance read for a named issuer — charter type, regulator, attestation cadence, reserve composition where disclosed, Federal Register rulemaking citations
- Data: Tavily search + Federal Register API (federalregister.gov, free, no key)
- Price: $0.25

GET /api/yield-compare
- Returns: effective-yield comparison across yield-bearing stablecoins (Ethena USDe, Ondo USDY, Sky USDS, BUIDL, USYC, etc.) and stablecoin neobank/card products (e.g. Plasma One) — every product labeled by GENIUS Act classification: issuer interest (restricted) vs third-party rewards (asserted exempt)
- Data: Tavily search
- Price: $0.25

GET /api/depeg-watch?symbol={ticker}
- Returns: current peg deviation vs $1, 30-day peg-deviation history, 24h-volume liquidity-depth proxy
- Data: CoinGecko (deterministic math, no LLM math)
- Price: $0.15

GET /api/flows?symbol={ticker}
- Returns: cross-chain circulating-supply distribution, 7d/30d migration deltas per chain
- Data: DeFiLlama stablecoins API (stablecoins.llama.fi, free, no key)
- Price: $0.15

GET /api/rails-compare?rails={comma-separated ids}
- Returns: comparison of stablecoin-native L1s (Plasma, Circle Arc, Stripe/Paradigm Tempo, Tether Stable) vs incumbent chains (Tron, Solana, Base) — fees, finality, ecosystem maturity
- Data: Tavily search (registry entries are identity/status only, no hardcoded fee numbers)
- Price: $0.25

GET /api/reserve-check?issuer={name}|stablecoin={ticker}
- Returns: reserve-attestation freshness (deterministic date-extraction staleness flag: fresh/aging/stale/unknown) and composition where disclosed
- Data: Tavily search
- Price: $0.20

GET /api/reg-watch?jurisdiction={code|name}
- Returns: stablecoin regulatory framework status for a jurisdiction — US grounded in Federal Register documents, non-US (EU/MiCA, UK, JP, SG, HK, AE, and any other jurisdiction) grounded in live search
- Data: Federal Register API (US) + Tavily search (global)
- Price: $0.15

GET /api/snapshot
- Returns: market-wide dashboard — total stablecoin market cap, 7d change, top gainers/losers, chain-share distribution, recent launch news
- Data: DeFiLlama + Tavily
- Price: $0.10

## Discovery

- OpenAPI spec: https://stablecoinpulse.theaslangroupllc.com/openapi.json
- Agent discovery: https://stablecoinpulse.theaslangroupllc.com/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON with a `generated_at` timestamp and a disclaimer
- Every numeric figure traces to a fetched source (DeFiLlama/CoinGecko/Federal Register) or a
  deterministic in-code computation — never a model-invented number
- Search-grounded endpoints (issuer-check, yield-compare, rails-compare, reserve-check, reg-watch)
  include a `web_sources` and/or `federal_register_citations` array of the actual URLs used
- If grounding data is unavailable, the endpoint returns an honest `insufficient_grounding` or
  `no_data_available` error rather than fabricating a result
- `lang` query param (all endpoints): response language, e.g. en, es, fr, de, ja, zh, ko, pt, ar
- This is intelligence/informational content only — not financial or legal advice