{"openapi":"3.1.0","info":{"title":"x402Pulse","version":"1.0.0","description":"Pay-per-call data for AI agents: Polymarket traders ranked by skill, FDA drug and CMS hospital data, EIA oil and CFTC positioning, Wikipedia attention, travel delay risk (FAA, NOAA, State Department, ECB) and Wall Street data from SEC filings, plus a daily Morning Brief. Paid per call in USDC on Base with x402: no account or API key.","x-guidance":"Every /v1 endpoint is a GET. Call it without payment to receive a 402 with the x402 challenge (price, network, payTo) and a free preview; pay with any x402 client (for example @x402/fetch) and retry to receive { data, cached }. Errors (4xx/5xx) are never charged. Start with /v1/wallstreet/morning-brief, /v1/travel/trip-check or /v1/disagreements for the richest single-call answers. A Pro key (Authorization: Bearer xp_live_…) from /v1/pro/pass replaces per-call payment for 30 days. Full guide: https://www.x402pulse.dev/llms.txt","contact":{"email":"gp@zionassets.com","url":"https://www.x402pulse.dev"}},"servers":[{"url":"https://www.x402pulse.dev"}],"x-discovery":{"payTo":"0x5e901f973C17E5542b4Da2A64C7fDc736B2A6e74","network":"eip155:8453","llms":"https://www.x402pulse.dev/llms.txt","mcp":"https://www.x402pulse.dev/api/mcp","catalog":"https://www.x402pulse.dev/catalog"},"tags":[{"name":"Prediction markets","description":"Who is actually good at prediction markets, what they hold, and where skilled money disagrees with the odds."},{"name":"Health","description":"Drug safety and signals, recalls, labels, approvals and shortages, plus hospital scorecards and rankings."},{"name":"Oil","description":"Prices, U.S. inventories and supply, hedge-fund positioning, and oil prediction markets with smart money."},{"name":"Attention","description":"Trending topics and sudden spikes of public interest from Wikipedia pageviews, any topic's attention history, and the prediction markets they touch."},{"name":"Travel","description":"Trip delay-risk checks, live FAA airport delays and ground stops, decoded airport weather and forecasts worldwide, State Department advisories and official exchange rates."},{"name":"Wall Street","description":"Company briefs from SEC filings: financials, insider buying and selling, material events and activist stakes, plus the Treasury yield curve."},{"name":"Pro","description":"30-day pass: unlimited calls within fair use, plus an MCP server."}],"paths":{"/v1/whales":{"get":{"operationId":"get_whale_trades","summary":"Polymarket whale trades","description":"Polymarket whale trades: the largest recent buys and sells across all markets above a size you choose, with trader name, outcome, price and USD size. 5- and 15-minute crypto markets filtered out. Pair with /v1/wallet to check whether a whale is any good.","tags":["Prediction markets"],"parameters":[{"name":"min","in":"query","required":false,"description":"Minimum trade size in USD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of trades, 1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"minUsd":1000,"trades":[{"wallet":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","name":"Theo4","side":"BUY","outcome":"Yes","price":0.62,"usd":12400,"market":"Example market?","slug":"example-market","time":"2026-10-01T12:00:00.000Z"}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallet":{"get":{"operationId":"get_wallet_scorecard","summary":"Polymarket trader scorecard for any wallet","description":"Polymarket trader scorecard for any wallet: skill score (0-100), edge over the odds paid, win rate vs. the win rate the odds implied, return (ROI), realized PnL, specialty and largest open positions. Scores the latest 200 finished bets, losses included.","tags":["Prediction markets"],"parameters":[{"name":"address","in":"query","required":true,"description":"Polymarket proxy wallet address","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.035"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"address":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","name":"Theo4","score":{"skill":78,"label":"Sharp","bets":120,"edge":0.11,"winRate":0.63,"expectedWinRate":0.52,"roi":0.31,"realizedPnlUsd":2205393,"specialty":"politics"},"openPositions":[]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/top-traders":{"get":{"operationId":"list_top_traders","summary":"Polymarket leaderboard re-ranked by skill, not size","description":"Polymarket leaderboard re-ranked by skill, not size: top traders by edge over the odds paid, return and consistency, for day, week, month or all time, optionally per category (sports, politics, crypto, economy). Exposes big-volume losers the profit leaderboard hides.","tags":["Prediction markets"],"parameters":[{"name":"period","in":"query","required":false,"description":"day, week, month or all (default month)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Optional: sports, politics, crypto, economy or other","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of traders, 1 to 25","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"period":"month","traders":[{"rank":1,"wallet":"0x84cfffc3f16dcc353094de30d4a45226eccd2f63","name":"mooseborzoi","skill":81,"label":"Sharp","edge":0.14,"winRate":0.66,"roi":0.37,"bets":200,"specialty":"sports","periodPnlUsd":76470}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/smart-money":{"get":{"operationId":"get_smart_money","summary":"Polymarket smart money for one market","description":"Polymarket smart money for one market: the biggest holders on each side, each scored for skill (edge, win rate, ROI), plus which way skilled money leans and whether it agrees with the market's odds. Accepts a market link, slug or condition ID. Data, not investment advice.","tags":["Prediction markets"],"parameters":[{"name":"market","in":"query","required":true,"description":"Polymarket market URL, slug or condition ID","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"question":"Example market?","outcomes":[{"name":"Yes","price":0.41},{"name":"No","price":0.59}],"lean":{"outcome":"Yes","share":0.72,"marketPrice":0.41,"vsMarket":0.31,"stance":"more confident than"},"summary":"Skilled holders lean Yes (72% of skill-weighted money, from 4 skilled holders), more confident than the market's 41%.","sides":[]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/skilled-whales":{"get":{"operationId":"get_skilled_whale_trades","summary":"Smart-money whale trades on Polymarket","description":"Smart-money whale trades on Polymarket: recent large trades by skilled (Solid or Sharp) traders only, each tagged with the trader's skill score, edge over the odds paid, return and specialty. Separates informed whales from big gamblers.","tags":["Prediction markets"],"parameters":[{"name":"min","in":"query","required":false,"description":"Minimum trade size in USD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of trades, 1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0525"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"minUsd":1000,"tradersScored":25,"trades":[{"wallet":"0xd38b71f3e8ed1af71983e5c309eac3dfa9b35029","name":"primm","side":"BUY","outcome":"Yes","price":0.44,"usd":18500,"market":"Example market?","skill":88,"label":"Sharp","edge":0.13,"roi":0.65,"specialty":"sports","time":"2026-10-01T12:00:00.000Z"}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/disagreements":{"get":{"operationId":"find_market_disagreements","summary":"Polymarket markets where smart money disagrees with the odds","description":"Polymarket markets where smart money disagrees with the odds: scans the 30 busiest open markets every 15 minutes and returns those where skilled traders' money implies a different probability than the price, tempered against thin evidence, with a low, medium or high confidence rating. Data, not investment advice.","tags":["Prediction markets"],"parameters":[{"name":"category","in":"query","required":false,"description":"Optional: sports, politics, crypto, economy or other","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of markets, 1 to 20","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"category":null,"scannedAt":"2026-10-05T12:00:00.000Z","marketsScanned":30,"markets":[{"question":"Example market?","slug":"example-market","category":"politics","priceYes":0.38,"skilledYesShare":0.57,"rawSkilledYesShare":0.81,"gap":0.19,"confidence":"medium","skilledHolders":4,"skilledUsd":120000,"summary":"Market prices Yes at 38%; skilled money implies 57%, leaning Yes (medium confidence, 4 skilled holders)."}]},"cached":true}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/drug-safety":{"get":{"operationId":"get_drug_safety","summary":"FDA drug safety snapshot","description":"FDA drug safety snapshot for any drug (brand or generic name): total adverse event reports, share serious and fatal, most-reported side effects and the quarterly report trend from FDA FAERS. Reports are not proof of causation. Data, not medical advice.","tags":["Health"],"parameters":[{"name":"drug","in":"query","required":true,"description":"Drug brand or generic name","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"drug":"atorvastatin","totalReports":52000,"seriousShare":0.6,"deathReportShare":0.04,"topReactions":[{"reaction":"myalgia","reports":3340,"share":0.064}],"quarterlyReports":[{"quarter":"2026-Q2","reports":2900}],"yearOverYearChange":0.05,"source":"openFDA FAERS (U.S. FDA)"},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/safety-signals":{"get":{"operationId":"detect_drug_safety_signals","summary":"Drug safety signals (FAERS)","description":"Drug safety signal detection (pharmacovigilance) from FDA FAERS: side effects reported disproportionately often with a drug versus all other drugs, using the proportional reporting ratio (PRR) and chi-square with standard Evans criteria. A statistical prompt for study, not evidence of harm. Not medical advice.","tags":["Health"],"parameters":[{"name":"drug","in":"query","required":true,"description":"Drug brand or generic name","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"drug":"atorvastatin","drugReports":52000,"reactionsChecked":25,"signalCount":3,"signals":[{"reaction":"rhabdomyolysis","reports":2020,"prr":14.2,"chiSquare":2650.4,"signal":true}],"method":"Proportional reporting ratio vs. all other drugs in FAERS (Evans criteria)."},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/recalls":{"get":{"operationId":"list_fda_recalls","summary":"FDA drug recalls and food recalls","description":"FDA drug recalls and food recalls: the latest FDA enforcement reports with recall class (Class I is most serious) explained in plain language, recalling firm, product, reason, status, dates and distribution. Filter by class, company and time window. openFDA data, not medical advice.","tags":["Health"],"parameters":[{"name":"type","in":"query","required":false,"description":"drug or food (default drug)","schema":{"type":"string"}},{"name":"class","in":"query","required":false,"description":"Optional: I, II or III","schema":{"type":"string"}},{"name":"firm","in":"query","required":false,"description":"Recalling company","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"1 to 365","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"type":"drug","classification":"Class I","days":30,"totalMatching":4,"byClass":{"Class I":4},"recalls":[{"recallNumber":"D-0001-2026","classification":"Class I","firm":"Example Labs","product":"Example 10 mg tablets","reason":"Failed impurity specification","reportDate":"2026-09-21"}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/drug-label":{"get":{"operationId":"get_drug_label","summary":"FDA drug label lookup","description":"FDA drug label lookup: boxed warning, approved indications, contraindications, warnings and drug interactions for any drug, plus brand and generic names, manufacturer and route, as clean structured text from openFDA. Not medical advice.","tags":["Health"],"parameters":[{"name":"drug","in":"query","required":true,"description":"Drug brand or generic name","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"drug":"warfarin","brandNames":["COUMADIN"],"genericNames":["WARFARIN SODIUM"],"hasBoxedWarning":true,"boxedWarning":"WARNING: BLEEDING RISK…","indications":"…","drugInteractions":"…","source":"openFDA drug labels (U.S. FDA)"},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/drug-approvals":{"get":{"operationId":"list_drug_approvals","summary":"FDA drug approvals","description":"FDA drug approvals: which companies just won FDA approval for new drugs, generics or biologics, from Drugs@FDA. Approval date, sponsor company, NDA/ANDA/BLA type, brand and active ingredients, dosage form, review priority, and a flag for novel drugs (new molecular entities). Filter by company, days and original vs. supplemental approvals.","tags":["Health"],"parameters":[{"name":"days","in":"query","required":false,"description":"1 to 365","schema":{"type":"string"}},{"name":"sponsor","in":"query","required":false,"description":"Company name","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"original (default), supplement or all","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"days":30,"kind":"original","totalFound":42,"byType":{"NDA":6,"ANDA":34,"BLA":2},"novelDrugs":2,"approvals":[{"date":"2026-09-28","applicationNumber":"NDA219876","applicationType":"NDA","sponsor":"EXAMPLE PHARMA INC","brandNames":["EXAMPLEX"],"activeIngredients":["EXAMPLINIB 50MG"],"novelDrug":true,"reviewPriority":"PRIORITY"}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/drug-shortages":{"get":{"operationId":"list_drug_shortages","summary":"FDA drug shortages","description":"FDA drug shortages: which medicines are in shortage now, grouped by drug, with availability (unavailable or limited) per package, companies, dosage forms, shortage reasons, estimated recovery notes and posting dates. Search one drug or list current shortages. For hospitals, pharmacies and supply chains. openFDA data, not medical advice.","tags":["Health"],"parameters":[{"name":"drug","in":"query","required":false,"description":"Drug brand or generic name","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"current (default), resolved, discontinued or all","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"query":"amino acid injection","status":"current","drugsFound":1,"packagesFound":4,"drugs":[{"drug":"Amino Acid Injection","packages":4,"availability":{"Unavailable":2,"Limited":2},"companies":["Baxter Healthcare Corporation"],"recoveryNotes":["Estimated recovery: December 2026"],"firstPosted":"2020-12-08","lastUpdated":"2026-09-30"}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/hospital":{"get":{"operationId":"get_hospital_scorecard","summary":"Hospital scorecard (CMS)","description":"Hospital scorecard for any U.S. Medicare hospital from the Centers for Medicare & Medicaid Services (CMS, the U.S. government agency): CMS overall star rating, type, ownership, emergency services, and how it compares with the national average on mortality, safety and readmissions (measures better, same, worse), plus its rank and percentile among rated hospitals in its state. Look up by CMS facility ID or name plus state. Not medical advice.","tags":["Health"],"parameters":[{"name":"id","in":"query","required":false,"description":"CMS facility ID","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Hospital name","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Two-letter state code","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.035"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"id":"030103","name":"Mayo Clinic Hospital","city":"Phoenix","state":"AZ","starRating":5,"vsNational":{"mortality":{"better":2,"same":6,"worse":0},"safety":{"better":4,"same":3,"worse":0},"readmissions":{"better":3,"same":7,"worse":0}},"netScore":9,"stateComparison":{"rank":1,"ofRatedHospitals":61,"percentile":100}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/health/hospitals":{"get":{"operationId":"rank_hospitals","summary":"Best hospitals ranking (CMS)","description":"Best hospitals ranking for a U.S. state or city from Centers for Medicare & Medicaid Services (CMS) Care Compare data: ranked by CMS star rating, then net score (quality measures better than national minus worse across mortality, safety and readmissions). Filter by city, minimum stars, emergency services and hospital type (acute, critical access, children's, psychiatric). Not medical advice.","tags":["Health"],"parameters":[{"name":"state","in":"query","required":false,"description":"Two-letter state code","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"Optional city","schema":{"type":"string"}},{"name":"minStars","in":"query","required":false,"description":"Optional 1 to 5","schema":{"type":"string"}},{"name":"emergency","in":"query","required":false,"description":"Optional true or false","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Optional: acute, critical, childrens or psychiatric","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0525"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"filters":{"state":"AZ","city":"Phoenix"},"hospitalsMatching":18,"hospitals":[{"rank":1,"id":"030103","name":"Mayo Clinic Hospital","starRating":5,"netScore":9,"measuresBetter":9,"measuresWorse":0}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/oil/prices":{"get":{"operationId":"get_oil_prices","summary":"Crude oil prices","description":"Crude oil prices: WTI and Brent daily spot prices from the U.S. Energy Information Administration (EIA), with 1-day, 1-week, 1-month and 1-year changes, 52-week range and position in it, and the Brent-WTI spread. Official daily figures, not live futures quotes. Data, not trading advice.","tags":["Oil"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"wti":{"date":"2026-09-29","price":96.16,"change1w":{"change":10.93,"changePct":0.128},"range52w":{"low":61.2,"high":99.37}},"brent":{"price":99.8},"brentWtiSpread":{"usdPerBarrel":3.64}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/oil/inventories":{"get":{"operationId":"get_oil_inventories","summary":"U.S. oil inventories (EIA)","description":"U.S. oil inventories from the EIA Weekly Petroleum Status Report: commercial crude, Cushing (WTI hub), Strategic Petroleum Reserve, gasoline and distillate stocks, each with the weekly build or draw, change vs. a year ago and vs. the 5-year average for the same week. Data, not trading advice.","tags":["Oil"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"weekEnding":"2026-09-25","stocks":[{"key":"crudeExSpr","thousandBarrels":427320,"weeklyChange":922,"vsFiveYearAveragePct":-0.021}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/oil/supply":{"get":{"operationId":"get_oil_supply","summary":"U.S. oil supply from the EIA weekly report","description":"U.S. oil supply from the EIA weekly report: crude production, refinery utilization, crude imports and exports (thousand barrels per day), weekly change, 4-week average, change vs. a year ago, and net imports. Data, not trading advice.","tags":["Oil"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"weekEnding":"2026-09-25","items":[{"key":"production","value":13400,"fourWeekAverage":13380}],"netImports":{"thousandBarrelsPerDay":2200}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/oil/positioning":{"get":{"operationId":"get_oil_positioning","summary":"WTI crude positioning (CFTC)","description":"WTI crude oil positioning from the CFTC Commitments of Traders: managed money (hedge funds) long, short and net contracts, weekly change, long/short ratio, and how extreme the net position is vs. the last 3 years (percentile), plus producers, swap dealers and open interest. Data, not trading advice.","tags":["Oil"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.035"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"reportDate":"2026-09-29","managedMoney":{"long":209028,"short":129436,"net":79592,"weeklyNetChange":-10059,"threeYearPercentile":82,"reading":"within its usual 3-year range"}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/oil/markets":{"get":{"operationId":"list_oil_markets","summary":"Oil prediction markets with smart money","description":"Oil prediction markets with smart money: busy Polymarket markets about oil prices, OPEC, Strait of Hormuz and fuel, each with the skilled-trader lean (skill-weighted money vs. the market's odds) from x402Pulse scoring. Data, not trading advice.","tags":["Oil"],"parameters":[{"name":"limit","in":"query","required":false,"description":"1 to 10","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"marketsFound":4,"markets":[{"question":"Will WTI close above $100 in October?","outcomes":[{"name":"Yes","price":0.38}],"skilledHolders":3,"skilledFirstOutcomeShare":0.52,"gapVsPrice":0.14}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/attention/trending":{"get":{"operationId":"list_trending_topics","summary":"Trending topics","description":"Trending topics: yesterday's most-viewed Wikipedia articles in any language, cleaned of site pages, with rank change vs. the day before, new entries, week-long regulars, and likely automated surges flagged separately. A daily read of what people are paying attention to. Based on Wikimedia pageview data (CC0).","tags":["Attention"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Wikipedia language code","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 100","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"project":"en.wikipedia","date":"2026-10-05","items":[{"rank":1,"title":"Christa Pike","views":333405,"rankChange":null,"isNew":true,"daysInTopThisWeek":1,"url":"https://en.wikipedia.org/wiki/Christa_Pike"}],"flaggedAutomated":[{"title":".xxx","views":218299}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/attention/spikes":{"get":{"operationId":"list_attention_spikes","summary":"Attention spikes","description":"Attention spikes: Wikipedia articles whose views surged far above their usual level yesterday (ratio to the previous week's median), the earliest sign of breaking public interest in a person, company, event or idea. Any language. Likely automated traffic filtered. Based on Wikimedia pageview data (CC0).","tags":["Attention"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Wikipedia language code (default en)","schema":{"type":"string"}},{"name":"minRatio","in":"query","required":false,"description":"2 to 100","schema":{"type":"string"}},{"name":"minViews","in":"query","required":false,"description":"Minimum views (default 1000)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.035"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"project":"en.wikipedia","date":"2026-10-05","items":[{"title":"Christa Pike","views":333405,"baseline":4100,"ratio":81.3,"ratioIsAtLeast":true,"newToTopList":true}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/attention/topic":{"get":{"operationId":"get_topic_attention","summary":"Attention history for any topic","description":"Attention history for any topic: daily Wikipedia pageviews of one article (a company, person, drug, coin or event) for 7 to 90 days, with its baseline, latest day vs. baseline, spike days and 7-day trend. Use the exact article title, e.g. Bitcoin. Based on Wikimedia pageview data (CC0).","tags":["Attention"],"parameters":[{"name":"title","in":"query","required":true,"description":"Exact Wikipedia article title","schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language code (default en)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"7 to 90","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"title":"Bitcoin","latest":{"date":"2026-10-05","views":2600,"vsBaseline":1},"baselineDailyViews":2513,"trend7d":-0.12,"spikeDays":[{"date":"2026-09-25","views":12376,"ratio":4.9}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/attention/markets":{"get":{"operationId":"list_attention_markets","summary":"Attention meets prediction markets","description":"Attention meets prediction markets: topics trending or spiking on Wikipedia matched to open Polymarket markets, each with prices and the skilled-trader lean from x402Pulse scoring. Find markets the public is suddenly paying attention to. Data, not investment advice.","tags":["Attention"],"parameters":[{"name":"lang","in":"query","required":false,"description":"Language code (default en)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 10","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"date":"2026-10-05","markets":[{"topic":"2026 Brazilian general election","topicViews":247828,"why":"trending","market":"Will Lula win the 2026 Brazilian presidential election?","skilledHolders":3,"skilledFirstOutcomeShare":0.44}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/travel/trip-check":{"get":{"operationId":"check_trip_delay_risk","summary":"Trip check","description":"Trip check: one call rates the delay risk (low, moderate, high) for a flight between two airports on a date, with plain-language reasons. Combines live FAA delays and ground stops, current airport weather and airport forecasts for both ends, the destination's State Department travel advisory, and the currency exchange rate for international trips. Any airport worldwide by IATA code, e.g. SFO to LHR. Not for flight planning.","tags":["Travel"],"parameters":[{"name":"from","in":"query","required":true,"description":"Origin airport (IATA like SFO or ICAO like KSFO)","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Destination airport","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"trip":{"from":{"code":"SFO"},"to":{"code":"LHR"},"date":"2026-10-07","international":true},"delayRisk":"moderate","coverage":"live","summary":"Delay risk for SFO to LHR on 2026-10-07: moderate. LHR: now: gusty winds (34 kt). United Kingdom is at State Department Level 2 (Exercise Increased Caution).","currency":{"from":"USD","to":"GBP","rate":0.7532}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/travel/airport-status":{"get":{"operationId":"get_airport_status","summary":"Airport status right now","description":"Airport status right now: live FAA delays, ground stops, ground delay programs and closures (restrictions that only affect private aircraft are labeled as such), plus current weather in plain words and a delay-risk rating. FAA data covers U.S. airports; weather covers airports worldwide. Not for flight planning.","tags":["Travel"],"parameters":[{"name":"airport","in":"query","required":true,"description":"Airport code (IATA or ICAO)","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"airport":{"code":"MIA","name":"Miami Intl"},"delayRisk":"moderate","riskReasons":["Arrival or departure delays (departures) (16–30 min, increasing), due to weather"],"weather":{"flightCategory":"VFR","summary":"wind from 90° at 10 kt; visibility 10+ miles; 29 °C. VFR: good conditions."}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/travel/airport-forecast":{"get":{"operationId":"get_airport_forecast","summary":"Airport weather forecast decoded","description":"Airport weather forecast decoded: the next 24 to 30 hours at any airport worldwide, broken into periods with wind, gusts, visibility, cloud ceiling, flight category and a delay-risk rating, flagging when low clouds, storms, snow or strong gusts are expected. Not for flight planning.","tags":["Travel"],"parameters":[{"name":"airport","in":"query","required":true,"description":"Airport code (IATA or ICAO)","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"airport":{"code":"LHR"},"forecast":{"delayRisk":"moderate","riskReasons":["gusty winds (32 kt) expected 06:00–14:00 UTC (2026-10-07)"],"periods":[{"from":"2026-10-07T06:00:00.000Z","to":"2026-10-07T14:00:00.000Z","flightCategory":"IFR","delayRisk":"moderate"}]}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/travel/disruptions":{"get":{"operationId":"list_flight_disruptions","summary":"FAA airspace disruptions","description":"Every current FAA disruption in U.S. airspace, ranked by severity: ground stops, ground delay programs, arrival and departure delays, airspace flow programs and real closures, with plain-language reasons. Private-aircraft-only restrictions are separated out so agents don't report them as closures. Not for flight planning.","tags":["Travel"],"parameters":[{"name":"includeRestrictions","in":"query","required":false,"description":"true or false","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"counts":{"groundStops":1,"groundDelayPrograms":1,"delays":1,"closures":0},"airportsAffected":["EWR","JFK","MIA"],"summary":"3 active FAA programs or delays affecting airline flights at EWR, JFK, MIA."},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/travel/advisory":{"get":{"operationId":"get_travel_advisory","summary":"U.S. State Department travel advisories","description":"U.S. State Department travel advisories: a country's level (1 Exercise normal precautions to 4 Do not travel), summary and main risk factors, or every country at or above a level. Country by 2-letter code (MX, GB, JP) or name.","tags":["Travel"],"parameters":[{"name":"country","in":"query","required":false,"description":"2-letter country code or name","schema":{"type":"string"}},{"name":"minLevel","in":"query","required":false,"description":"1 to 4","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"advisory":{"country":"Saudi Arabia","level":3,"levelText":"Reconsider Travel","riskFactors":["armed conflict","terrorism","exit bans"]}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/travel/exchange-rates":{"get":{"operationId":"get_exchange_rates","summary":"Official exchange rates","description":"Official exchange rates: the European Central Bank's daily reference rates for about 30 currencies, converted to any base currency (USD by default). Source: ECB statistics. Reference rates, not trading rates.","tags":["Travel"],"parameters":[{"name":"base","in":"query","required":false,"description":"3-letter currency code","schema":{"type":"string"}},{"name":"symbols","in":"query","required":false,"description":"Comma-separated currency codes","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"date":"2026-10-06","base":"USD","rates":{"EUR":0.88739,"GBP":0.753217,"JPY":158.089}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallstreet/company-brief":{"get":{"operationId":"get_company_brief","summary":"Company brief from SEC filings in one call","description":"Company brief from SEC filings in one call: latest-quarter and trailing-year financials with margins and growth, insider buying and selling over 90 days (open-market vs. pre-planned 10b5-1 trades, cluster-buy detection), material events from 8-K filings decoded into plain words, new 5%+ and activist stakes, and a plain-language summary. Any U.S.-listed ticker. Data, not investment advice.","tags":["Wall Street"],"parameters":[{"name":"ticker","in":"query","required":true,"description":"U.S. stock ticker","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.35"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"company":{"ticker":"AAPL","name":"Apple Inc.","industry":"Electronic Computers"},"summary":"Latest quarter (ended 2026-06-27): revenue $109.4B, +16% vs. a year ago, net income $29.8B, net margin 27%. Insiders, last 90 days: 1 sale ($33.2M, 100% under pre-arranged 10b5-1 plans).","insiders":{"openMarketBuys":0,"openMarketSells":1,"clusterBuy":false,"plannedSellShare":1}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallstreet/morning-brief":{"get":{"operationId":"get_morning_brief","summary":"Morning Brief: 2026's top-performing stocks","description":"Morning Brief for 2026's top-performing stocks (28 companies, from SanDisk and Micron to CrowdStrike and Lam Research): today's ranked signals from SEC filings (insider cluster buys, insider selling outside pre-arranged 10b5-1 plans with the main seller named, serious 8-K events, activist stakes), a one-line summary per company, and the macro backdrop (Treasury yield curve, oil positioning, skilled prediction-market money on the economy). Refreshed three times a day. Data, not investment advice.","tags":["Wall Street"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.35"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"date":"2026-10-08","title":"2026's top-performing stocks","tickers":["SNDK","MRNA","DELL"],"signals":[{"ticker":"NVDA","weight":1.5,"text":"Insiders sold $946.6M outside pre-arranged 10b5-1 plans. All by Stevens Mark A."}],"companies":[{"ticker":"MU","name":"MICRON TECHNOLOGY INC","revenueGrowthYoY":0.52,"netMargin":0.31,"buys":0,"sells":4,"plannedSellShare":1}],"macro":{"curve":"2026-10-07: 10-year 5.28%, 2-year 4.77%…","oil":"Hedge-fund net position 79,592 contracts, 29th percentile of 3 years."}},"cached":true}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallstreet/insider-trades":{"get":{"operationId":"list_insider_trades","summary":"Insider trades decoded from SEC Form 4 filings","description":"Insider trades decoded from SEC Form 4 filings: who traded (name, role, title), buy or sell, shares, price, dollar value, holdings afterwards, and whether the trade was pre-planned under a 10b5-1 plan, plus totals and cluster-buy detection. Data, not investment advice.","tags":["Wall Street"],"parameters":[{"name":"ticker","in":"query","required":true,"description":"Stock ticker, e.g. NVDA","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"7 to 365","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 60","schema":{"type":"string"}},{"name":"openMarketOnly","in":"query","required":false,"description":"true or false","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0525"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"summary":{"openMarketBuys":0,"openMarketSells":4,"sellValueUsd":41200000,"plannedSellShare":1,"clusterBuy":false},"trades":[{"insider":"COOK TIMOTHY D","title":"Executive Chair","direction":"sell","shares":129963,"price":255.38,"valueUsd":33189951,"planned":true}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallstreet/financials":{"get":{"operationId":"get_company_financials","summary":"Standardized company financials from SEC XBRL filings","description":"Standardized company financials from SEC XBRL filings: revenue, net and operating income, diluted EPS, operating cash flow for the last 8 quarters and 5 years, plus cash, assets, liabilities, equity, debt and shares outstanding, with margins, year-over-year growth and trailing-12-month totals. Handles companies that changed reporting labels. Data, not investment advice.","tags":["Wall Street"],"parameters":[{"name":"ticker","in":"query","required":true,"description":"Stock ticker, e.g. MSFT","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.035"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"summary":{"latestQuarter":{"periodEnd":"2026-06-27","revenue":109417000000,"netMargin":0.272,"revenueGrowthYoY":0.164},"trailing12Months":{"revenue":466823000000}}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallstreet/events":{"get":{"operationId":"list_company_events","summary":"Material corporate events (8-K)","description":"Material corporate events from SEC 8-K filings, decoded and ranked: bankruptcies, auditor changes, restatements, executive departures, acquisitions, major agreements, earnings releases, plus new 5%+ and activist stakes, each with a link to the filing. Data, not investment advice.","tags":["Wall Street"],"parameters":[{"name":"ticker","in":"query","required":true,"description":"Stock ticker, e.g. TSLA","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"7 to 365","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0175"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"counts":{"high":0,"notable":1,"routine":2},"events":[{"filed":"2026-10-02","importance":"notable","items":[{"code":"5.02","meaning":"Director or executive departure or appointment"}]}]},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/wallstreet/yield-curve":{"get":{"operationId":"get_yield_curve","summary":"U.S. Treasury yield curve","description":"U.S. Treasury yield curve: the latest daily yields from 1 month to 30 years, the 10Y-2Y and 10Y-3M spreads, inversion flags (a closely watched recession signal) and changes vs. the previous day, a month and a year ago. Data, not investment advice.","tags":["Wall Street"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.00875"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"date":"2026-10-06","yieldsPct":{"3 Mo":4.21,"2 Yr":4.79,"10 Yr":5.27},"spreadsBp":{"10Y-2Y":48,"10Y-3M":106},"inverted":{"10Y-2Y":false,"10Y-3M":false}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/pro/pass":{"get":{"operationId":"buy_pro_pass","summary":"x402Pulse Pro pass (30 days)","description":"x402Pulse Pro: a 30-day pass for $39 USDC that returns an API key for unlimited calls (fair use: 120 a minute, 20,000 a day) to every x402Pulse endpoint, plus an MCP server for Claude Code, Cursor and Claude Desktop. To renew, send your current key as Authorization: Bearer <key>; renewals add 30 days to the time left. The key is shown once.","tags":["Pro"],"parameters":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"39.0"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"The result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object"},"cached":{"type":"boolean"}},"required":["data"]},"example":{"data":{"plan":"x402Pulse Pro","key":"xp_live_…","expiresAt":"2026-11-05T12:00:00.000Z","use":{"header":"Authorization: Bearer xp_live_…","mcp":"https://www.x402pulse.dev/api/mcp"}},"cached":false}}}},"400":{"description":"Missing or invalid parameter (never charged)."},"402":{"description":"Payment required: the PAYMENT-REQUIRED header carries the x402 v2 challenge (USDC on Base). Free to request."},"404":{"description":"Not found (never charged)."}}}},"/v1/pro/status":{"get":{"operationId":"get_pro_status","summary":"Pro pass status","description":"Expiry, days left and today's usage for a Pro key. Free.","tags":["Pro"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Status of the key."},"401":{"description":"Missing, invalid or expired key."}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"An x402Pulse Pro key (xp_live_…). Optional on paid routes as an alternative to paying per call; required for /v1/pro/status."}}}}