# x402Pulse

> Pay-per-call data for AI agents in six collections: skill-ranked Polymarket traders; FDA drug data (safety, signals, recalls, labels, approvals, shortages) and hospital scorecards and rankings from the Centers for Medicare & Medicaid Services (CMS); crude oil data from the U.S. Energy Information Administration (EIA) and CFTC; attention data (trending topics and spikes) from Wikipedia pageviews; travel data (trip delay-risk checks, FAA airport status, airport weather, State Department advisories, ECB exchange rates); and Wall Street data (company briefs, insider trades, financials and 8-K events from SEC filings; Treasury yield curve). Pay in USDC with the x402 protocol. No API key or account.

## How to call
- Base URL: https://www.x402pulse.dev
- All endpoints are GET and return JSON: { data, cached }.
- Without payment, a paid endpoint returns 402 with a PAYMENT-REQUIRED header (base64 JSON: scheme, network, amount in USDC base units, asset, payTo).
- Sign the payment with an x402 client (e.g. @x402/fetch + @x402/evm), resend with a PAYMENT-SIGNATURE header, and receive 200 plus a PAYMENT-RESPONSE receipt.
- Network: Base mainnet (eip155:8453). Errors (4xx/5xx) are never charged.

## Pro (optional)
- Buy a 30-day pass at https://www.x402pulse.dev/v1/pro/pass (an x402 endpoint) to get an API key for unlimited calls within fair-use limits.
- Send it as Authorization: Bearer xp_live_… on any endpoint to skip per-call payment.
- MCP server for Claude Code, Cursor and other MCP clients: https://www.x402pulse.dev/api/mcp (same header).

## Endpoints
### GET /v1/whales ($0.0028)
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.
- param min: Minimum trade size in USD (default 1000)
- param limit: Number of trades, 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/whales?min=1000&limit=20
- returns trades[] (list): Largest recent trades, biggest first.
- returns wallet, name (text): Trader's Polymarket wallet and display name (null if none).
- returns side, outcome, price (text, text, 0–1): BUY or SELL, which outcome, and the price paid (0.62 = 62¢).
- returns usd, shares (USD, number): Trade size in dollars and shares.
- returns market, slug, time, tx (text): Market question, its slug, trade time (ISO) and on-chain transaction.

### GET /v1/wallet ($0.0056)
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.
- param address: Polymarket wallet address (0x…)
- example: https://www.x402pulse.dev/v1/wallet?address=0xd38b71f3e8ed1af71983e5c309eac3dfa9b35029
- returns address, name (text): The wallet and its display name (null if none).
- returns score (object): The scorecard. See score fields below.
- returns openPositions[] (list): Largest live positions: market, outcome, shares, avgPrice, currentPrice, valueUsd, unrealizedPnlUsd.

### GET /v1/top-traders ($0.014)
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.
- param period: day, week, month or all (default month)
- param category: Optional: sports, politics, crypto, economy or other
- param limit: Number of traders, 1 to 25 (default 10)
- example: https://www.x402pulse.dev/v1/top-traders?period=month&limit=10
- returns traders[] (list): Traders ranked by skill. Each has the main score fields plus the ones below.
- returns profitRank (integer): Where they sat on Polymarket's profit leaderboard for the period.
- returns periodPnlUsd, periodVolumeUsd (USD): Profit and volume for the chosen period, from Polymarket.
- returns candidates (integer): How many leaderboard traders were scored to build the ranking.
- returns category (text or null): When set, scores use only each trader's bets in that category.

### GET /v1/smart-money ($0.014)
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.
- param market: Market link, market slug or condition ID
- example: https://www.x402pulse.dev/v1/smart-money?market=xi-jinping-out-before-2027
- returns question, slug, outcomes[] (text, list): The market, and each outcome with its current price (0.41 = 41% implied chance).
- returns lean (object or null): outcome, share of skill-weighted money, marketPrice, vsMarket (share − price) and stance: in line with, more confident than, or less confident than the market.
- returns summary (text): One-sentence answer, ready to show a user.
- returns sides[] (list): Per outcome: price, sharpHolders, skillWeightedUsd and holders[] (wallet, name, valueUsd, skill, label, edge, winRate, roi).

### GET /v1/skilled-whales ($0.0084)
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.
- param min: Minimum trade size in USD (default 1000)
- param limit: Number of trades, 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/skilled-whales?min=1000&limit=20
- returns trades[] (list): Large recent trades by Solid or Sharp traders only, biggest first. Same trade fields as /v1/whales.
- returns skill, label, edge, roi, specialty (score): The trader's skill score and its main parts. See score fields below.
- returns tradersScored (integer): How many distinct traders were scored (up to 25 of the biggest).

### GET /v1/disagreements ($0.028)
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.
- param category: Optional: sports, politics, crypto, economy or other
- param limit: Number of markets, 1 to 20 (default 5)
- example: https://www.x402pulse.dev/v1/disagreements?limit=5
- returns markets[] (list): Open yes/no markets, sorted by how far tempered skilled money is from the price, weighted by confidence.
- returns priceYes (0–1): The market's price for the first outcome (usually Yes).
- returns skilledYesShare (0–1): What skilled money implies for the first outcome, tempered toward the price so thin readings can't look extreme.
- returns rawSkilledYesShare (0–1): The untempered share of skill-weighted money on the first outcome.
- returns gap (−1 to 1): skilledYesShare − priceYes. Positive: skilled money more bullish on Yes than the market; negative: more bullish on No.
- returns confidence (text): high (5+ skilled holders, $150K+ skill-weighted), medium (3+, $50K+) or low.
- returns skilledHolders, skilledUsd (integer, USD): How many Solid+ holders and how much skill-weighted money the reading rests on.
- returns scannedAt, marketsScanned (time, integer): When the busiest open markets were last scanned (every 15 minutes) and how many.

### GET /v1/health/drug-safety ($0.0028)
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.
- param drug: Drug brand or generic name, e.g. atorvastatin or Lipitor
- example: https://www.x402pulse.dev/v1/health/drug-safety?drug=atorvastatin
- returns totalReports (integer): All FAERS adverse event reports mentioning the drug (brand or generic name).
- returns seriousShare, deathReportShare (0–1): Share of those reports marked serious, and share reporting a death. Reports are unverified.
- returns topReactions[] (list): Most-reported side effects: reaction, reports and share of the drug's reports.
- returns quarterlyReports[], yearOverYearChange (list, number): Reports per quarter for the last 8 full quarters, and the latest quarter vs. a year earlier.
- returns notice (text): Reporting caveats. Show it with the data.

### GET /v1/health/safety-signals ($0.014)
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.
- param drug: Drug brand or generic name
- example: https://www.x402pulse.dev/v1/health/safety-signals?drug=atorvastatin
- returns signals[] (list): Reactions meeting the Evans criteria (PRR ≥ 2, ≥ 3 reports, chi-square ≥ 4), strongest first.
- returns prr (number): Proportional reporting ratio: how many times more often the reaction is reported with this drug than with all others. 1 = no difference.
- returns chiSquare (number): How unlikely the difference is by chance (4 or more passes the screen).
- returns checked[], reactionsChecked (list, integer): Every reaction tested (the drug's 100 most reported), signal or not.
- returns method, notice (text): How signals were computed, why a signal is not evidence of harm, and confounding by indication.

### GET /v1/health/recalls ($0.0014)
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.
- param type: drug or food (default drug)
- param class: Optional: I, II or III
- param firm: Optional: recalling company
- param days: Look-back window, 1 to 365 (default 30)
- param limit: Number of recalls, 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/health/recalls?type=drug&class=I&days=30
- returns recalls[] (list): Newest first: recall number, class, severity meaning, status, firm, product, reason, report and start dates, distribution.
- returns byClass, totalMatching (object, integer): Counts by class among the newest 50, and all matching recalls in the window.
- returns classification (text): Class I: serious harm or death is reasonably likely. Class II: temporary or reversible problems. Class III: unlikely to cause harm.

### GET /v1/health/drug-label ($0.0014)
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.
- param drug: Drug brand or generic name
- example: https://www.x402pulse.dev/v1/health/drug-label?drug=warfarin
- returns brandNames, genericNames, manufacturers, routes (lists): Identity of the labeled product.
- returns hasBoxedWarning, boxedWarning (boolean, text): Whether the label carries FDA's strongest warning, and its text.
- returns indications, contraindications, warnings, drugInteractions (text): Excerpts of those label sections (up to 1,500 characters each).
- returns labelDate (date): When this label version took effect.

### GET /v1/health/drug-approvals ($0.0028)
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.
- param days: Look-back window, 1 to 365 (default 30)
- param sponsor: Optional: company name
- param kind: original (default), supplement or all
- param limit: Number of approvals, 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/health/drug-approvals?days=30&kind=original
- returns approvals[] (list): Newest first: date, application number and type (NDA, ANDA, BLA), sponsor, original or supplement, brand names, active ingredients, dosage forms, routes, approval class, review priority.
- returns novelDrug, novelDrugs (boolean, integer): Whether an original approval is a new molecular entity (Type 1), and how many in the window.
- returns byType, totalFound (object, integer): Approvals by application type, and how many were found in the window.

### GET /v1/health/drug-shortages ($0.0028)
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.
- param drug: Optional: drug name; omit to list current shortages
- param status: current (default), resolved, discontinued or all
- param limit: Number of drugs, 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/health/drug-shortages?drug=lisdexamfetamine
- returns drugs[] (list): One entry per drug: statuses, packages listed, availability counts, companies, brand names, dosage forms, routes, categories, reasons, recovery notes, first posted and last updated.
- returns availability (object): Packages by availability, e.g. { Unavailable: 2, Limited: 1 }.
- returns severity (0–1): Share of the drug's packages that are unavailable or limited. Results are sorted by it, worst first.
- returns estimatedRecovery (list): Recovery or availability dates pulled from FDA's notes, e.g. "March 2027" or "TBD".
- returns recoveryNotes (list): FDA's full notes, which can also name distributors or allocation.
- returns drugsFound, packagesFound (integer): Drugs matching, and package listings behind them.

### GET /v1/health/hospital ($0.0056)
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.
- param id: CMS facility ID (6 characters), or
- param name: Hospital name (with state)
- param state: Two-letter state, required with name
- example: https://www.x402pulse.dev/v1/health/hospital?name=Mayo+Clinic+Hospital&state=AZ
- returns starRating, starRatingNote (1–5 or null, text): Overall star rating from the Centers for Medicare & Medicaid Services (CMS), or why it isn't rated.
- returns vsNational.mortality / safety / readmissions (object): CMS measures in each group: total, reported, and how many are better, no different or worse than the national average.
- returns netScore, measuresBetter, measuresWorse, measuresCompared (integers): x402Pulse analysis: measures better minus worse across the three groups, and the totals behind it.
- returns stateComparison (object): x402Pulse rank and percentile among rated hospitals in the same state.
- returns patientExperience, timelyCare (object): How many of these CMS measures the hospital reported (CMS gives no better/worse counts for them here).

### GET /v1/health/hospitals ($0.0084)
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.
- param state: Two-letter state (omit for nationwide)
- param city: Optional city
- param minStars: Optional 1 to 5
- param emergency: Optional true or false
- param type: Optional: acute, critical, childrens or psychiatric
- param limit: 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/health/hospitals?state=AZ&city=Phoenix&emergency=true
- returns hospitals[] (list): Ranked: id, name, city, state, type, ownership, emergency services, star rating, net score and measure counts.
- returns hospitalsMatching, ratedHospitals (integers): Hospitals matching the filters, and how many have a CMS star rating.
- returns method (text): How the x402Pulse ranking orders hospitals.

### GET /v1/oil/prices ($0.0014)
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.
- example: https://www.x402pulse.dev/v1/oil/prices
- returns wti, brent (object): Latest EIA daily spot price (USD per barrel) with date, change1d/1w/1m/1y (from, change, changePct), 52-week range and positionInRange (0 = low, 1 = high), and the last 10 readings.
- returns brentWtiSpread (object): Brent minus WTI on the latest shared date.

### GET /v1/oil/inventories ($0.0028)
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.
- example: https://www.x402pulse.dev/v1/oil/inventories
- returns stocks[] (list): Commercial crude (ex-SPR), Cushing, SPR, gasoline and distillate: thousand barrels, weeklyChange (negative = draw), vsYearAgoPct, fiveYearAverage, vsFiveYearAveragePct.
- returns weekEnding (date): Week the EIA report covers (published the following Wednesday).

### GET /v1/oil/supply ($0.0028)
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.
- example: https://www.x402pulse.dev/v1/oil/supply
- returns items[] (list): Production, refinery utilization, imports and exports: value, units, weeklyChange, fourWeekAverage, vsYearAgoPct.
- returns netImports (object): Crude imports minus exports, thousand barrels per day.

### GET /v1/oil/positioning ($0.0056)
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.
- example: https://www.x402pulse.dev/v1/oil/positioning
- returns managedMoney (object): Hedge funds and CTAs in WTI futures: long, short, net, weeklyNetChange, longShortRatio, netShareOfOpenInterest, threeYearPercentile, 3-year low/high and a plain-language reading.
- returns otherGroupsNet (object): Net positions of producers and merchants, swap dealers and other reportable traders.
- returns recentWeeks[] (list): Last 8 weeks of managed-money net and open interest.

### GET /v1/oil/markets ($0.014)
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.
- param limit: Number of markets, 1 to 10 (default 10)
- example: https://www.x402pulse.dev/v1/oil/markets?limit=10
- returns markets[] (list): Oil-related Polymarket markets: question, outcomes with prices, skilledHolders, skilledUsd, skilledFirstOutcomeShare (tempered), gapVsPrice and a reading.

### GET /v1/attention/trending ($0.0028)
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).
- param lang: Wikipedia language code, e.g. en, es, pt, de (default en)
- param limit: Number of topics, 1 to 100 (default 25)
- example: https://www.x402pulse.dev/v1/attention/trending?lang=en&limit=25
- returns items[] (list): Top articles: rank, title, views, previousRank, rankChange (positive = climbed), isNew, daysInTopThisWeek, steady, mobileShare, url.
- returns flaggedAutomated[] (list): Pages with almost no mobile traffic, a common sign of automated views, kept out of the ranking.
- returns date, sitePagesRemoved (date, integer): The UTC day measured, and how many site pages (main page, search) were removed.

### GET /v1/attention/spikes ($0.0056)
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).
- param lang: Wikipedia language code (default en)
- param minRatio: Minimum surge, 2 to 100 (default 3)
- param minViews: Minimum views (default 1000)
- param limit: 1 to 50 (default 20)
- example: https://www.x402pulse.dev/v1/attention/spikes?lang=en&minRatio=3
- returns items[] (list): Surging articles: title, views, baseline (median of the previous week), ratio, ratioIsAtLeast, newToTopList, url.
- returns comparedDays, filters (integer, object): Earlier days compared, and the minRatio and minViews applied.

### GET /v1/attention/topic ($0.0014)
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).
- param title: Exact Wikipedia article title, e.g. Bitcoin
- param lang: Language code (default en)
- param days: 7 to 90 (default 30)
- example: https://www.x402pulse.dev/v1/attention/topic?title=Bitcoin&days=30
- returns latest, baselineDailyViews (object, integer): The latest day's views and multiple of baseline, and the median daily views over the period.
- returns spikeDays[], trend7d (list, number): Days at 3x baseline or more, and the last 7 days vs. the 7 before (0.2 = +20%).
- returns daily[] (list): Views per day (human traffic).

### GET /v1/attention/markets ($0.014)
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.
- param lang: Language code (default en)
- param limit: 1 to 10 (default 10)
- example: https://www.x402pulse.dev/v1/attention/markets?lang=en
- returns markets[] (list): Topic, its views and why it was picked (trending or spike), the matched Polymarket market, prices, skilled holders, skilledFirstOutcomeShare and a reading.

### GET /v1/travel/trip-check ($0.014)
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.
- param from: Origin airport code, e.g. SFO
- param to: Destination airport code, e.g. LHR
- param date: Travel date YYYY-MM-DD (default today, UTC). Weather forecasts reach about 30 hours ahead
- example: https://www.x402pulse.dev/v1/travel/trip-check?from=SFO&to=LHR
- returns delayRisk, coverage (text, text): low, moderate or high for the route and date; coverage says whether it used live data (today), forecasts, or none (dates beyond about 30 hours).
- returns summary (text): Plain-language verdict with the most serious reasons first, plus the destination advisory level.
- returns origin, destination (object): Per airport: delayRisk, riskReasons, live FAA events, current weather, and forecast periods covering the travel date.
- returns travelAdvisory, currency (object): The destination's State Department advisory, and the exchange rate from the origin's to the destination's currency (international trips).

### GET /v1/travel/airport-status ($0.0028)
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.
- param airport: Airport code, e.g. JFK, SFO, LHR or KJFK
- example: https://www.x402pulse.dev/v1/travel/airport-status?airport=JFK
- returns delayRisk, riskReasons (text, list): Combined from FAA programs and current weather, most serious first.
- returns faa.events[] (list): Each with type (ground_stop, ground_delay_program, delay, closure, restriction), severity, affectsAirlineFlights, delay minutes and a plain reason.
- returns weather (object): flightCategory (VFR good to LIFR very poor), wind, gusts, visibility, ceiling, conditions and a plain summary.

### GET /v1/travel/airport-forecast ($0.0028)
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.
- param airport: Airport code, e.g. LHR, ORD or EGLL
- example: https://www.x402pulse.dev/v1/travel/airport-forecast?airport=ORD
- returns forecast.periods[] (list): Time window, change type (from, temporarily, becoming, possibly), wind, visibility, ceiling, flightCategory and delayRisk.
- returns forecast.delayRisk, riskReasons (text, list): The worst expected period and why, with times in UTC.

### GET /v1/travel/weather ($0.0014)
Weather anywhere: current conditions, the next 12 hours and a daily forecast up to about 9 days (high, low, precipitation and its chance, wind) for any coordinates or airport, in °C and °F. U.S. locations add the National Weather Service forecast in words and any active weather alerts. Sources: MET Norway worldwide, NWS for the U.S.
- param lat: Latitude in decimal degrees, e.g. 37.77
- param lon: Longitude in decimal degrees, e.g. -122.42
- param airport: Instead of lat/lon: an airport code, e.g. SFO or LHR
- param tz: Optional IANA time zone for the daily breakdown, e.g. Europe/Paris (U.S. locations detect it automatically)
- param name: Optional place name to label the answer, e.g. Paris
- example: https://www.x402pulse.dev/v1/travel/weather?lat=37.77&lon=-122.42&name=San+Francisco
- returns summary (text): One or two plain sentences: conditions and temperature now, today's high, low and chance of precipitation, and the number of active alerts.
- returns now (object): conditions, temperatureC/F, feelsLikeC/F, humidityPct, cloudCoverPct, wind (km/h, mph, direction, gusts), precipitationNextHourMm, uvIndex.
- returns days[] (list): Local calendar days: conditions, highC/F, lowC/F, precipitationMm/In, chanceOfPrecipitationPct, windMaxKmh/Mph.
- returns next12Hours[] (list): Hour by hour: local time, temperature, conditions, precipitation and its chance.
- returns alerts[], nws (list, object): U.S. only: active National Weather Service alerts (event, severity, headline, times, instructions) and the NWS forecast periods in words. null elsewhere.

### GET /v1/travel/disruptions ($0.0028)
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.
- param includeRestrictions: true to also list restrictions that don't affect airline flights (default false)
- example: https://www.x402pulse.dev/v1/travel/disruptions
- returns counts, airportsAffected (object, list): Active ground stops, ground delay programs, delays, airspace programs and real closures; airports involved.
- returns events[] (list): Ranked most severe first, only items that affect airline flights. restrictions[] (optional) lists private-aircraft-only notices.

### GET /v1/travel/advisory ($0.0014)
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.
- param country: Country code or name, e.g. MX or Mexico (omit to list countries)
- param minLevel: When listing: minimum level 1 to 4 (default 3)
- example: https://www.x402pulse.dev/v1/travel/advisory?country=MX
- returns advisory (object): country, level (1 to 4), levelText, summary, riskFactors, someAreasHigherRisk, url and dates.
- returns advisories[] (list): When no country is given: every country at or above minLevel, highest first.

### GET /v1/travel/exchange-rates ($0.0014)
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.
- param base: Base currency, e.g. USD (default), EUR, GBP
- param symbols: Optional comma-separated currencies, e.g. EUR,JPY,MXN
- example: https://www.x402pulse.dev/v1/travel/exchange-rates?base=USD&symbols=EUR%2CGBP%2CJPY
- returns rates (object): Units of each currency per 1 unit of base.
- returns perEuro, date (object, date): The ECB euro reference rates as published, and their date.

### GET /v1/wallstreet/company-brief ($0.056)
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.
- param ticker: Stock ticker, e.g. AAPL, NVDA or BRK.B
- example: https://www.x402pulse.dev/v1/wallstreet/company-brief?ticker=AAPL
- returns summary (text): Plain-language brief: latest quarter, insider activity (with cluster buys and planned-sale share) and notable events.
- returns financials (object): latestQuarter (revenue, net and operating income, EPS, margins, growth vs. a year ago), trailing12Months and balanceSheet.
- returns insiders (object): 90 days: openMarketBuys/Sells, buyers, sellers, dollar values, net, plannedSellShare, clusterBuy, recentTrades.
- returns materialEvents[], largeStakes[] (list): 8-K events ranked high, notable or routine with decoded items and links; 13D (activist) and 13G (passive 5%+) filings.

### GET /v1/wallstreet/morning-brief ($0.056)
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.
- example: https://www.x402pulse.dev/v1/wallstreet/morning-brief
- returns signals[] (list): Up to 12 ranked signals: ticker and plain-English text (cluster buys, unplanned insider selling with the main seller, serious 8-Ks, activist stakes).
- returns companies[] (list): Per company: name, latest-quarter revenue, growth vs. a year ago, net margin, insider buys and sales over 90 days, share of sales pre-planned, notable 8-K count.
- returns macro (object): curve (yield-curve summary), oil (hedge-fund positioning), markets[] (skilled money vs. the odds on economy markets), spikes[].
- returns date, generatedAt, title, tickers (text, time, text, list): The brief's day, when it was built, the watchlist's name and its 28 tickers.

### GET /v1/wallstreet/insider-trades ($0.0084)
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.
- param ticker: Stock ticker, e.g. NVDA
- param days: Look-back window, 7 to 365 (default 90)
- param limit: Max filings to read, 1 to 60 (default 25)
- param openMarketOnly: true to list only open-market buys and sales (default false)
- example: https://www.x402pulse.dev/v1/wallstreet/insider-trades?ticker=NVDA&days=90
- returns trades[] (list): insider, roles, title, date, code and type, direction (buy, sell, other), openMarket, planned (10b5-1), shares, price, valueUsd, sharesOwnedAfter, url.
- returns summary (object): Totals for the period and clusterBuy (3+ insiders buying within 30 days).

### GET /v1/wallstreet/financials ($0.0056)
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.
- param ticker: Stock ticker, e.g. MSFT
- example: https://www.x402pulse.dev/v1/wallstreet/financials?ticker=MSFT
- returns summary (object): Latest quarter with margins and growth, trailing 12 months, balance sheet.
- returns quarters, years (object): Per metric (revenue, netIncome, operatingIncome, epsDiluted, operatingCashFlow, cash, totalAssets, ...): period, end date, value, form.

### GET /v1/wallstreet/events ($0.0028)
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.
- param ticker: Stock ticker, e.g. TSLA
- param days: Look-back window, 7 to 365 (default 90)
- example: https://www.x402pulse.dev/v1/wallstreet/events?ticker=TSLA
- returns events[] (list): filed, form, items (code and plain meaning), importance (high, notable, routine), url.
- returns counts, largeStakes[] (object, list): Events by importance; 13D/13G stake filings in the period.

### GET /v1/wallstreet/yield-curve ($0.0014)
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.
- example: https://www.x402pulse.dev/v1/wallstreet/yield-curve
- returns yieldsPct, date (object, date): Yields in percent for 1 month to 30 years on the latest business day.
- returns spreadsBp, inverted (object): 10Y-2Y, 10Y-3M and 30Y-5Y spreads in basis points; inversion flags.
- returns changeBp (object): Change per maturity vs. the previous day, about a month ago and a year ago.

### GET /v1/pro/pass ($19.97)
x402Pulse Pro: a 30-day pass for $19.97 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.
- example: https://www.x402pulse.dev/v1/pro/pass
- returns key (text): Your Pro API key (xp_live_…). Shown once; save it. Send it as Authorization: Bearer <key>.
- returns expiresAt, days (time, integer): When the pass ends. Renewals add 30 days to any remaining time.
- returns use (object): Ready-to-copy header, curl example, MCP URL and the Claude Code command.
- returns limits (object): Fair use: calls per minute and per day.

## Score fields
- skill (0–100): Overall skill score from edge, return, history size and consistency.
- label (text): Sharp (70+), Solid (45+), Mixed (25+), Weak, or Too few bets (under 10 finished bets).
- edge (number): Win rate minus the win rate the prices paid implied. 0.08 = won 8 points more often than the odds said.
- winRate (0–1): Share of finished bets that made money.
- expectedWinRate (0–1): Average price paid, i.e. the win rate the odds implied.
- roi (number): Realized profit divided by money invested. 0.25 = +25%.
- bets (integer): Finished bets scored (latest 200, losses included).
- realizedPnlUsd (USD): Profit or loss across the scored bets.
- biggestWinShare (0–1): Share of all winnings from the single best bet. High means one lucky hit.
- shortTermShare (0–1): Share of bets on 5- and 15-minute crypto markets, which lowers the score.
- specialty (text): Category with the most profit: sports, politics, crypto, economy, other, or null.

## How the skill score works
- Uses a wallet's latest 200 finished bets, including unredeemed losses.
- edge = win rate − average price paid. Base score = 60% edge (−2 pts → 0, +10 pts → full) + 40% return (0% → 0, +30% → full).
- Multiplied by history size, consistency (one lucky bet halves it) and focus (5/15-minute coin-flip markets halve it). Capped at 35 if edge ≤ 0 or return ≤ 0.
- Smart money: skill-weighted dollars of Solid+ holders per outcome; lean compared with the outcome's price (±10 pts = in line).

## Errors
- 400 (free): Missing or invalid parameter; the message says which. An ambiguous market link or hospital name includes choices[] to pick from.
- 402 (free): Payment required: read the PAYMENT-REQUIRED header, pay, and retry.
- 404 (free): Not found: e.g. an unknown wallet, market, drug, hospital, article, airport, country or ticker.
- 429 (free): Too many requests from you: 60 paid calls a minute, or 600 free price checks a minute. Retry-After says when to try again.
- 502 / 503 (free): A data source (Polymarket, openFDA, CMS, EIA, CFTC, Wikimedia, FAA, NOAA, State Department, ECB, SEC or Treasury) didn't respond or is busy, or payments are briefly unavailable. Retry after a short wait.

## Freshness
- Whales: refreshed every minute.
- Smart money: every 5 minutes.
- Wallet: every 10 minutes. A wallet's skill score: every 30 minutes.
- Top traders: every 15 minutes. Disagreements: rescanned in the background every 15 minutes. Skilled whales: every 3 minutes.
- Health: openFDA and CMS results are cached for several hours; the sources themselves update daily (FDA) to quarterly (CMS).
- Oil: EIA spot prices daily (several business days behind the market), inventories and supply weekly, CFTC positioning weekly.
- Attention: Wikipedia pageviews cover the previous full UTC day; results refresh hourly.
- Travel: FAA status about every minute, airport weather every 5 minutes, forecasts every 15 minutes, advisories hourly, ECB rates daily.
- Wall Street: SEC filings within about 20 minutes of the SEC listing them, financials every 12 hours, Treasury yields daily (cached up to an hour).
- Every response has cached: true or false, so you can tell whether it was just computed.

## Discovery
- https://www.x402pulse.dev/catalog and https://www.x402pulse.dev/.well-known/x402-listing: endpoints and prices as JSON.
- https://www.x402pulse.dev/openapi.json: OpenAPI 3.1 with x402 payment info per operation. https://www.x402pulse.dev/.well-known/x402: x402 discovery manifest.
- Human docs: https://www.x402pulse.dev/developers

## Usage notes
- Market data and analytics from public Polymarket activity. Not financial or betting advice.
- Health data from openFDA (U.S. FDA, public domain). Adverse event reports are unverified and do not prove causation. Not medical advice.
- Oil data from the U.S. Energy Information Administration (EIA) and the CFTC Commitments of Traders. Spot prices lag the market; not live futures. Not investment or trading advice.
- Attention data is based on Wikipedia pageview data from the Wikimedia Foundation (CC0), about a day behind. Titles, counts and links only. Not affiliated with Wikimedia.
- Travel data comes from the FAA, NOAA Aviation Weather Center, U.S. State Department (public) and ECB statistics. Information only, not for flight planning or navigation.
- Wall Street data comes from SEC EDGAR filings and U.S. Treasury yields (public). No stock prices. Data, not investment advice.
- Hospital ratings and measures are data from the Centers for Medicare & Medicaid Services (CMS, the U.S. government agency behind Medicare Care Compare). Rankings and net scores are x402Pulse analysis based on CMS data. Not medical advice.
- Independent service, not affiliated with Polymarket, the FDA, CMS, EIA, the CFTC, the Wikimedia Foundation, the FAA, NOAA, the State Department, the ECB, the SEC, the Treasury or the x402 Foundation.