{"openapi":"3.1.0","info":{"title":"XR-Pulse™","description":"Normalized XRPL signal feed. Two sources in one time-ordered JSON stream: public-source news (regulatory press, central banks, crypto-press coverage of Ripple/XRP/RLUSD/XRPL) and on-chain whale activity (every successful XRPL Payment above the storage threshold). News events carry mechanical cross-verification and a four-hour price-window correlation; whale events carry sender + receiver labels resolved from the institutional watchlist. Deterministic heuristic data only; not an endorsement of news legitimacy. Provided by XRPL-Utilities™ LLC.","termsOfService":"https://pulse.xrpl-utilities.io/tos","version":"1.14.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Root Post","operationId":"root_post__post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agents.json":{"get":{"summary":"Get Agents Manifest","operationId":"get_agents_manifest__well_known_agents_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/agents.json":{"get":{"summary":"Get Agents Manifest","operationId":"get_agents_manifest_agents_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/tos":{"get":{"summary":"Get Tos","description":"Machine-readable terms of service. Mirrors the shape of XR-Sentinel\n/tos and XR-Telemetry /tos so consumers can discover all three with the\nsame parser. Linked from the canonical /terms section on the .com\nmarketing site.","operationId":"get_tos_tos_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Get Llms Txt","description":"Crawler context for AI tools. Mirrors XR-Sentinel/XR-Telemetry/XR-Trust\npattern so AI agents discovering one service can parse the same shape on\nevery service in the portfolio.","operationId":"get_llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Get Robots","operationId":"get_robots_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/schema":{"get":{"summary":"Get Schema","operationId":"get_schema_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/stats/top-destinations":{"get":{"summary":"Stats Top Destinations","description":"Top destinations receiving from multiple distinct watchlist sources.\nSurfaces consolidator addresses (OTC desks, bridges, custodians) for\noperator labeling into watchlist.STATIC_AUGMENT, and gives consumers\nvisibility into where institutional flow is concentrating.\n\nOpen endpoint: every datum derives from the public XRPL ledger and\nXRPScan's public well-known label list. The aggregations are\nsummaries any caller could compute themselves; auth would be\ncosmetic. Read-only.\n\nQuery params: min_distinct_sources (default 2, must be >=1),\n              limit (default 30, capped at 200).","operationId":"stats_top_destinations_stats_top_destinations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/stats":{"get":{"summary":"Stats","operationId":"stats_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/events/recent":{"post":{"summary":"Events Recent","description":"Return up to `limit` most-recent events. Free for the marketing-site\norigin; paid via x402 for everyone else.","operationId":"events_recent_events_recent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecentEventsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/backfill_whales":{"post":{"summary":"Admin Backfill Whales","description":"One-shot repair pass over historical whale_xrpl events whose\nactive_utility was clobbered by an earlier active_utility_loop bug.\nRe-derives the canonical {signal: 'whale_transfer', ...} block from\nfields still in the row (title, brief, target_addresses) - no XRPL\nRPC calls. Idempotent: rows already carrying signal=='whale_transfer'\nare skipped, so re-runs are no-ops.\n\nAuth via X-Admin-Key matching D_BYPASS_KEY (same gate as the dev\nbypass on /events/recent).","operationId":"admin_backfill_whales_admin_backfill_whales_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_BackfillRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"RecentEventsRequest":{"properties":{"limit":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Limit","default":50},"since_iso":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since Iso","examples":["2026-04-01T00:00:00Z"]},"min_whale_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Min Whale Usd"}},"type":"object","title":"RecentEventsRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"_BackfillRequest":{"properties":{"hours_back":{"type":"integer","maximum":168.0,"minimum":1.0,"title":"Hours Back","default":24}},"type":"object","title":"_BackfillRequest"}}}}