{"openapi":"3.1.0","info":{"title":"IMPERIUM Pulse","version":"1.0.0","description":"Machine-readable market intelligence for tokenized stocks, priced per call in USDG on Robinhood Chain over x402.","x-logo":{"url":"https://imperium-fi.com/logo.png","altText":"IMPERIUM"},"x-guidance":"IMPERIUM Pulse is machine-readable market intelligence for tokenized stocks on Robinhood Chain, priced per call in USDG over the x402 protocol.\n\nHow to use it:\n1. GET /v1/pulse/resources (free) lists every resource with its price in USDG.\n2. POST /v1/pulse/{resource} with a JSON body like {\"symbol\": \"AAPL\"}. Without payment the call returns 402 Payment Required with x402 v2 payment requirements (Robinhood Chain, USDG via Permit2).\n3. Approve Permit2 for USDG once, build and sign the payment (the facilitator relays the transaction and pays gas, so your wallet only needs USDG plus that one-time approval), then retry the same request with the X-PAYMENT header. Standard x402 clients handle this automatically.\n\nSymbols are tokenized stocks: AAPL, NVDA, TSLA, MSFT, AMZN, GOOGL, META, SPY. The symbol field is optional and defaults to AAPL. Prices range 0.05-0.10 USDG per call. All responses include an asOf timestamp."},"servers":[{"url":"https://api.imperium-fi.com"}],"paths":{"/v1/pulse/resources":{"get":{"operationId":"pulse-resources","summary":"List Pulse resources and prices (free)","description":"Catalog of every Pulse resource with its path, description, and price in USDG. Free to call.","security":[],"responses":{"200":{"description":"Resource catalog","content":{"application/json":{"schema":{"type":"object","properties":{"resources":{"type":"array","items":{"type":"object"}}}},"example":{"resources":[{"path":"pulse/momentum","name":"Momentum","description":"Directional momentum for a tokenized asset: bias, strength, confidence, and time horizon.","priceUsd":0.05,"currency":"USDG","network":"robinhood","status":"preview"},{"path":"pulse/sentiment","name":"Sentiment","description":"Aggregated market sentiment, interpreted for machines.","priceUsd":0.05,"currency":"USDG","network":"robinhood","status":"preview"},{"path":"pulse/risk","name":"Risk","description":"Structured risk analysis for an asset or portfolio.","priceUsd":0.08,"currency":"USDG","network":"robinhood","status":"preview"},{"path":"pulse/regime","name":"Regime","description":"Current market regime classification with supporting factors.","priceUsd":0.05,"currency":"USDG","network":"robinhood","status":"preview"},{"path":"pulse/fundamentals","name":"Fundamentals","description":"Structured fundamental analysis for a tokenized stock.","priceUsd":0.1,"currency":"USDG","network":"robinhood","status":"preview"},{"path":"pulse/anomaly","name":"Anomaly","description":"Unusual behavior, activity spikes, and shifting conditions, surfaced early.","priceUsd":0.08,"currency":"USDG","network":"robinhood","status":"preview"}]}}}}}}},"/v1/pulse/momentum":{"post":{"operationId":"pulse-momentum","summary":"Momentum: 0.05 USDG per call","description":"Directional momentum for a tokenized asset: bias, strength, confidence, and time horizon.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","enum":["AAPL","NVDA","TSLA","MSFT","AMZN","GOOGL","META","SPY"],"default":"AAPL","description":"Tokenized stock symbol to analyze. Defaults to AAPL."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Machine-readable momentum analysis","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"bias":{"type":"string","enum":["bullish","neutral","bearish"]},"strength":{"type":"number"},"confidence":{"type":"number"},"horizon":{"type":"string"},"indicators":{"type":"object","properties":{"rsi14":{"type":"number"},"macdSignal":{"type":"string"},"volumeTrend":{"type":"string"}}}}},"example":{"symbol":"AAPL","asOf":"2026-08-29T23:06:42.765Z","bias":"neutral","strength":0.75,"confidence":0.61,"horizon":"1 week","indicators":{"rsi14":46.9,"macdSignal":"negative","volumeTrend":"contracting"}}}}},"402":{"description":"Payment Required"}}}},"/v1/pulse/sentiment":{"post":{"operationId":"pulse-sentiment","summary":"Sentiment: 0.05 USDG per call","description":"Aggregated market sentiment, interpreted for machines.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","enum":["AAPL","NVDA","TSLA","MSFT","AMZN","GOOGL","META","SPY"],"default":"AAPL","description":"Tokenized stock symbol to analyze. Defaults to AAPL."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Machine-readable sentiment analysis","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"score":{"type":"number"},"label":{"type":"string"},"sources":{"type":"object","properties":{"news":{"type":"number"},"social":{"type":"number"}}},"drivers":{"type":"array","items":{"type":"string"}}}},"example":{"symbol":"AAPL","asOf":"2026-08-29T23:06:42.765Z","score":-0.7,"label":"negative","sources":{"news":36,"social":249},"drivers":["earnings coverage","options flow chatter"]}}}},"402":{"description":"Payment Required"}}}},"/v1/pulse/risk":{"post":{"operationId":"pulse-risk","summary":"Risk: 0.08 USDG per call","description":"Structured risk analysis for an asset or portfolio.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","enum":["AAPL","NVDA","TSLA","MSFT","AMZN","GOOGL","META","SPY"],"default":"AAPL","description":"Tokenized stock symbol to analyze. Defaults to AAPL."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Machine-readable risk analysis","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"volatility30d":{"type":"number"},"beta":{"type":"number"},"varDaily95Pct":{"type":"number"},"concentrationFlag":{"type":"boolean"},"notes":{"type":"string"}}},"example":{"symbol":"AAPL","asOf":"2026-08-29T23:06:42.765Z","volatility30d":0.273,"beta":1.27,"varDaily95Pct":1.52,"concentrationFlag":false,"notes":"Elevated event risk within the horizon window."}}}},"402":{"description":"Payment Required"}}}},"/v1/pulse/regime":{"post":{"operationId":"pulse-regime","summary":"Regime: 0.05 USDG per call","description":"Current market regime classification with supporting factors.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","enum":["AAPL","NVDA","TSLA","MSFT","AMZN","GOOGL","META","SPY"],"default":"AAPL","description":"Tokenized stock symbol to analyze. Defaults to AAPL."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Machine-readable regime analysis","content":{"application/json":{"schema":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time"},"regime":{"type":"string"},"volatilityState":{"type":"string"},"breadth":{"type":"number"},"confidence":{"type":"number"}}},"example":{"asOf":"2026-08-29T23:06:42.765Z","regime":"risk-off","volatilityState":"elevated","breadth":63,"confidence":0.64}}}},"402":{"description":"Payment Required"}}}},"/v1/pulse/fundamentals":{"post":{"operationId":"pulse-fundamentals","summary":"Fundamentals: 0.10 USDG per call","description":"Structured fundamental analysis for a tokenized stock.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","enum":["AAPL","NVDA","TSLA","MSFT","AMZN","GOOGL","META","SPY"],"default":"AAPL","description":"Tokenized stock symbol to analyze. Defaults to AAPL."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Machine-readable fundamentals analysis","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"revenueGrowthYoyPct":{"type":"number"},"grossMarginPct":{"type":"number"},"peForward":{"type":"number"},"qualityScore":{"type":"number"},"summary":{"type":"string"}}},"example":{"symbol":"AAPL","asOf":"2026-08-29T23:06:42.765Z","revenueGrowthYoyPct":-3.6,"grossMarginPct":37.5,"peForward":24.8,"qualityScore":0.43,"summary":"Valuation runs ahead of near-term fundamentals."}}}},"402":{"description":"Payment Required"}}}},"/v1/pulse/anomaly":{"post":{"operationId":"pulse-anomaly","summary":"Anomaly: 0.08 USDG per call","description":"Unusual behavior, activity spikes, and shifting conditions, surfaced early.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","enum":["AAPL","NVDA","TSLA","MSFT","AMZN","GOOGL","META","SPY"],"default":"AAPL","description":"Tokenized stock symbol to analyze. Defaults to AAPL."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Machine-readable anomaly analysis","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"asOf":{"type":"string","format":"date-time"},"anomalyDetected":{"type":"boolean"},"type":{"type":["string","null"]},"zScore":{"type":"number"},"window":{"type":"string"},"note":{"type":"string"}}},"example":{"symbol":"AAPL","asOf":"2026-08-29T23:06:42.765Z","anomalyDetected":false,"type":null,"zScore":1.69,"window":"6h","note":"No significant divergence from baseline."}}}},"402":{"description":"Payment Required"}}}}}}