# Dynamic Feed — complete tool reference (llms-full.txt)

> The live, verifiable data layer for AI — 90 live tools.
> Every response carries provenance (source, licence, timestamp, age) and an Ed25519
> signature verifiable against https://dynamicfeed.ai/.well-known/keys (spec: /standard).
> Keyless over MCP (`npx dynamicfeed-mcp`) and on the /v1 agent endpoints below; broader
> REST uses a free X-API-Key (POST /signup). Short overview: https://dynamicfeed.ai/llms.txt

## Keyless agent endpoints (plain HTTPS, no signup — call these from anywhere)

- GET  https://dynamicfeed.ai/v1                      — discovery index (every endpoint, self-describing)
- GET  https://dynamicfeed.ai/v1/nearby?lat=-33.87&lon=151.21&radius_km=300
       signed live hazards around a point (quakes, fires, floods, storms; AU bushfire detail)
- POST https://dynamicfeed.ai/v1/awareness            — {"robot":{"class":"ground"},"location":{...}}
       go / caution / no-go verdict for ground/aerial/marine/orbital/humanoid machines
- GET  https://dynamicfeed.ai/v1/attest?metric=wind_kmh&op=gte&threshold=120&lat=-19.26&lon=146.82
       signed parametric trigger attestation (MET / NOT-MET at a location, provable)
- GET  https://dynamicfeed.ai/v1/trigger-receipt?...  — dispute-grade trigger receipt (pinned
       methodology hash + re-fetchable source URL + reproducible reading hash)
- POST https://dynamicfeed.ai/v1/receipt              — {"data": <any JSON>} → signed timestamped record
- POST https://dynamicfeed.ai/v1/notarize             — X-API-Key; notarize YOUR data (or just its
       sha256) → signed third-party witness record ("Let's Encrypt for data feeds")
- POST https://dynamicfeed.ai/v1/anchor               — anchor any signed record on Bitcoin (OpenTimestamps)
- POST https://dynamicfeed.ai/v1/notary/feeds        — X-API-Key; register a feed URL for CONTINUOUS
       notarization (every change witnessed into the public log automatically)
- GET  https://dynamicfeed.ai/v1/notary/log          — PUBLIC notary transparency log: append-only,
       hash-chained record of every notarization (hashes only); head anchored to Bitcoin daily
- GET  https://dynamicfeed.ai/v1/benchmark            — live-facts benchmark: signed eval set every frozen
       model fails (answers measured from authoritative sources at call time)
- POST https://dynamicfeed.ai/v1/batch                — {"calls":[{"tool":"earthquakes","args":{...}}, ...]}
- GET  https://dynamicfeed.ai/v1/sources              — every upstream source with its licence

## Verification (do not trust — check)

1. Take any response; remove its `signature` field.
2. Canonicalize: JSON with sorted keys, compact separators ("," ":"), UTF-8 (Python json.dumps
   sort_keys=True, separators=(',',':')).
3. Verify the Ed25519 `signature.sig` over those bytes against the public key at
   https://dynamicfeed.ai/.well-known/keys (key id df-ed25519-4cb32e72f333).
   Reference verifiers: https://dynamicfeed.ai/verify.js and /proof (in-browser).

## All 90 MCP tools, grouped by catalog vertical

Call keyless over MCP: `npx dynamicfeed-mcp` (stdio) or HTTPS MCP at https://dynamicfeed.ai/mcp

### Developer & Web (5)

- **cert_check** — Live TLS/SSL certificate check for any domain — direct handshake right now: issuer, validity window, days to expiry, SANs, negotiated TLS version. Valid? Expiring? Who issued it?
- **dns_lookup** — Live DNS records for a domain via Cloudflare DNS-over-HTTPS (keyless): A / AAAA / MX / TXT / NS / CNAME / SOA / CAA. What's actually live in DNS now.
- **github_releases** — Latest releases for a GitHub repo (owner/name) — version, date, author, link — via the public releases atom feed (keyless, no rate limit). What's the newest release of a library/tool right now.
- **hacker_news** — Live Hacker News stories (keyless) — the tech/AI attention layer. kind = top | new | best; optional case-insensitive title filter. Returns title, score, comments, url.
- **internet_outages** — Live BGP routing health for a network resource (ASN like AS3215, an IP, or a prefix) from RIPEstat (RIPE NCC). Global visibility + an outage signal (healthy/degraded/outage) — a sharp visibility drop = the network is losing global reachability.

### Energy (3)

- **carbon_intensity** — Live electricity-grid carbon intensity (gCO2/kWh) + the generation fuel mix for a region (Carbon Intensity API, keyless). Time compute/charging for low-carbon windows.
- **energy_grid** — Live US electricity grid data by region/operator (EIA v2, public domain): demand, net generation, or current fuel mix (MW). region = US48 (national) or CAISO/PJM/MISO/ERCOT/ISONE/NYISO/SPP/BPA; metric = demand|generation|mix. Hourly.
- **grid_carbon** — Live grid carbon intensity (gCO2/kWh): current value, trend vs ~3 hours ago, and the live generation mix by fuel. Regions: au (Australian NEM, default) | nsw | qld | vic | sa | tas (single NEM state) | uk (Great Britain) | all (AU + UK). AU values are DERIVED and honestly flagged so (method in response): live AEMO 5-minute dispatch SCADA weighted by AEMO's own CDEII per-generator CO2e emission factors — AEMO's official daily CDEII index rides alongside for cross-checking. GB values are NESO-measured. Complements carbon_intensity (UK-only, cleanest-window forecast). Keyless; AEMO general permission — any purpose with attribution — + NESO CC BY 4.0.

### Flights & Airports (5)

- **airport_delays** — Live FAA airport delays, ground stops, closures & ground-delay programs (US National Airspace System, keyless). By 3-letter airport code or all current disruptions.
- **aviation_weather** — Live aviation weather — decoded METAR observations + TAF forecasts for any ICAO airport (NOAA Aviation Weather Center, public domain, keyless). Returns flight category (VFR / MVFR / IFR / LIFR), winds, visibility, ceilings and the raw METAR/TAF report — the same data a pilot sees in a preflight briefing, accessible by any AI agent or robot in one call. station = any 4-letter ICAO airport code (default YBBN = Brisbane; KJFK, EGLL, YSSY, OMDB, RJTT all served; US stations fully covered; major international airports covered via ICAO/WMO distribution to NOAA). kind = metar (default) | taf | both. Cross-reference gps_interference for GNSS outages affecting aircraft and airport_delays for FAA ground stops. Source: NOAA Aviation Weather Center (aviationweather.gov) — US Government work, public domain (17 U.S.C. § 105). CAVEAT: observational/forecast data only — not a substitute for an official preflight briefing (FAA ATIS/AFIS or an authorized flight planning service).
- **gps_interference** — Probable GPS/GNSS interference (jamming/spoofing) over an area, measured from live ADS-B navigation integrity (the GPSJam method). Region preset (london, blacksea, baltic, easternmed, persiangulf, korea, finland, caucasus, northsea) or lat+lon. High degraded_fraction = aircraft losing GPS = probable interference. Derived by Dynamic Feed from adsb.lol (CC0).
- **live_flights** — Live aircraft positions right now — real-time flight tracking from the OpenSky Network. Answers 'what's flying over X?' and 'where is flight Y?'. Airborne flights first.
- **transit_status** — Live transit line status — is my line/train delayed right now? Covers Transport for London (Tube, DLR, Overground, Elizabeth line, Trams, UK National Rail), BART, and ~85 agencies worldwide via GTFS-Realtime. Lines with issues first.

### Government & Compliance (9)

- **clinical_trials** — Live clinical-trial registrations and status updates from ClinicalTrials.gov (US NIH/NLM registry). Returns the most-recently-updated trials, each with: NCT id, title, status (recruiting / completed / terminated / ...), phase, conditions, lead sponsor (+ class), study type, enrollment, start / primary-completion / completion dates, location count + countries, and first-posted / last-update dates. condition = disease/condition filter (melanoma, type 2 diabetes, alzheimer). query = free-text search across the whole record (intervention, sponsor, keyword — crispr, Pfizer, semaglutide). Both empty (argless default) = the most-recently-updated notable trials registry-wide. Keyless; US Government public domain (17 U.S.C. § 105), courtesy of the U.S. National Library of Medicine. Self-reported registry data — informational only, not medical advice.
- **drug_shortages** — US drug shortages from the FDA (openFDA, keyless) — is drug X in shortage right now, with status, reason and company. Newest updates first.
- **fda_recalls** — Recent FDA-regulated RECALLS & enforcement actions via openFDA — regulatory facts, NO prices. category = drug (default) | food | device. query = optional product / firm / reason search term (e.g. "Pfizer", "peanut", "contamination"); blank = the most recent in that category. limit = max items (default 15, cap 25). Per item: product description, recalling firm, reason for recall, classification (Class I/II/III severity), status (Ongoing/Completed/Terminated), recall-initiation date, distribution pattern, state/country, recall number. Plus a short summary, counts by classification, total_matches, and the newest recall date surfaced separately as latest_recall_date. Answers what FDA-regulated medicines / food / medical devices have been recalled lately, by whom, why, and how serious — a live public record a training snapshot can't have. DISTINCT from product_recalls (CPSC consumer goods — toys, appliances) and drug_shortages (FDA supply gaps, not defect withdrawals). Source: openFDA (api.fda.gov, U.S. FDA), U.S. Government work — public domain (CC0 1.0); keyless, ~1 h cache. INFORMATIONAL ONLY — openFDA data is NOT for clinical or safety decision-making and may be incomplete; confirm against the official FDA record before acting. HARD CONSTRAINT: every value is a regulatory/safety fact (firm, reason, class, status, date) — never a market price.
- **federal_register** — Recent US Federal Register documents — rules, proposed rules, notices, executive orders (keyless). What regulation took effect / what the President signed; total post-cutoff blindness for models.
- **global_indicator** — A flagship development statistic from Our World in Data: the latest value for a country plus a short multi-year trend, with full source attribution. ONE source, MANY indicators (breadth) — CO2 per capita, population, fertility, urbanisation, GDP-per-capita (a development stat in PPP, NOT a market price), extreme poverty, R&D spend, Human Development Index, literacy, internet & electricity access. Distinct from global_macro (World Bank): OWID adds the long-run development + climate set. indicator = a slug/alias from the curated allowlist (default co2-emissions-per-capita; aliases: co2, pop, gdp, hdi, literacy, internet, poverty, fertility, urban, rd); call indicator='list' for the menu. country = ISO-3 code (AUS, USA, CHN, GBR, IND, …); omit for the World aggregate. Source: Our World in Data (ourworldindata.org) — OWID's processing layer is CC BY 4.0, keyless; every response carries BOTH OWID's attribution AND each underlying producer's citation + licence. Only indicators whose underlying sources are cleared for commercial re-serving (CC BY / CC BY IGO / CC0 / public domain) are served — a fail-closed runtime gate refuses any non-redistributable indicator. Annual-ish statistics, not a live-telemetry feed.
- **health_surveillance** — US public-health surveillance signals from the CDC — the current level + week-over-week direction of circulating illness, not individual case data. topic = respiratory (default — emergency-department visit shares + clinical-lab test positivity for COVID-19 / influenza / RSV) | wastewater (CDC NWSS viral-activity levels in community wastewater, an early-warning leading indicator). Each metric carries its reporting week + trend. COVERAGE: United States ONLY (CDC networks); a population-level signal with reporting lag, not a real-time case count or diagnosis. Source: CDC (cdc.gov) NSSP + NWSS open datasets — US Government public domain (17 U.S.C. § 105), keyless; carries CDC attribution + the standard non-endorsement note. Informational only, not medical advice.
- **product_recalls** — Recent US product & food recalls (FDA / openFDA, keyless) — what's recalled now, with reason, status and company. Newest first.
- **sanctions_screen** — Screen a name against the US OFAC SDN + UK Sanctions List (FCDO, Open Government Licence) — keyless. Each match is tagged with its list (US-OFAC | UK). A match means the party is sanctioned — legally binding the instant it's posted. Optional program/regime filter (e.g. IRAN, CUBA, or a UK regime).
- **sec_filings** — Recent SEC EDGAR filings for a public company by ticker — 10-K, 10-Q, 8-K and more, with filing date and document link. The post-cutoff corporate-disclosure layer.

### Ground-truth & Utility (13)

- **cite** — A fresh, CITEABLE source + timestamp for a current datapoint — so you can cite it, not guess. Pass an asset (BTC, gold, EURUSD, AAPL) for a live priced value with source + as-of time, or a news topic for a current headline + source URL. Returns a ready-to-use citation string.
- **convert** — Convert an amount between currencies at the live exchange rate (e.g. 100 USD to EUR).
- **countdown** — Time until a LIVE event you can't compute without a clock: a market open/close (NYSE, NASDAQ, LSE, TSE, HKEX, SSE, ASX, XETRA) or the next rocket launch (optionally a provider, e.g. 'next SpaceX launch'). Returns a human countdown + seconds + the target time.
- **current_time** — The current date and time anywhere — an LLM has no internal clock, so call this instead of guessing 'today' or 'now'. tz is an IANA timezone (e.g. America/New_York); default UTC. Returns UTC + local time, date, weekday, weekend flag, ISO week and unix time.
- **detect_drift** — Audit a batch of an AI's stated facts against live ground-truth — drift detection. Each claim is graded drifted / confirmed / unverifiable with a severity, plus a correction and source. Covers live software versions, market open/closed and service up/down. Use to catch where a model's answer has gone stale.
- **market_hours** — Is the market open right now? Live open/closed status + next open/close for major exchanges (NYSE, NASDAQ, LSE, XETRA, TSE, HKEX, ASX) plus crypto (24/7) and forex (24/5). Tells whether a price is live or a closed-market last-print.
- **public_holidays** — Public / statutory holidays for a country (and optional state/province/region) in a given year — computed in-house, NOT scraped, so it's exact and offline-stable. Per holiday: date, name, weekday, whether it's an observed-day shift, the country, and the subdivision (when one was requested), plus the next upcoming holiday. country = ISO-3166 alpha-2 code (default AU); common names accepted (australia, usa, uk, new zealand). 100+ countries. year = 4-digit year (default current). subdiv = optional subdivision code (NSW/VIC/QLD for AU, CA/NY for US, ENG/SCT for GB). Pairs with market_hours. Holiday DATES are non-copyrightable facts; computed via the open-source holidays library (vacanza, MIT) — commercial use + redistribution permitted, keyless. Informational only — confirm against the official gazette for legal/payroll use.
- **reality_check** — Fact-check a statement against LIVE data — the anti-hallucination tool. Pass any claim about the current world ('BTC is $90,000', 'the stock market is open', 'the latest Python is 3.12', 'GitHub is down') and get a verdict (accurate / stale_or_wrong / current_value / outside_coverage), the live value, a confidence, and the source. Covers live prices, market hours, software versions and service status; returns 'outside_coverage' for anything it can't verify against a feed — it never guesses.
- **whats_changed_since_your_training** — What you've MISSED since your training cutoff — a live snapshot of the current world from Dynamic Feed: the trending new AI model, live prices of commonly-misquoted assets (BTC, ETH, NVDA, gold, Nasdaq), today's most actively-exploited CVE, the latest software versions, a top world headline, and the fastest AI API right now, plus a plain-English summary. Your training is frozen; this is the data it can't have. Call it on connect or whenever asked about current events.
- **wikidata_facts** — Structured factual statements about a named entity from Wikidata — the collaboratively-curated knowledge base behind Wikipedia. Resolves entity to its Wikidata item, then returns the headline facts: description, instance/class, key properties (for a country: capital, population, area, head of government, currency, ISO codes; for a person: birth/death, occupation, citizenship), cross-reference identifiers and the Wikidata QID. entity = a name to look up (Australia, Albert Einstein, Sydney Opera House, Bitcoin); default Australia. Reference/knowledge lookup, not live telemetry — values are as-current-as Wikidata's community edits. Source: Wikidata (wikidata.org), MediaWiki Action API — CC0 1.0 public domain: commercial use + redistribution permitted, no key, no attribution required.
- **wikipedia_trends** — What the world is paying attention to — top-viewed Wikipedia articles (global zeitgeist, ~1-day lag), or a topic's 14-day attention trend with week-over-week change. CC0 pageview data.
- **world_events** — Latest global news-event coverage from the GDELT Project, which monitors worldwide news in 100+ languages: the most recent articles matching a keyword (optional, matched against full article text) from outlets in a country (optional), within the past N hours. Argless = a global pulse of the latest coverage. Article metadata only — titles, links, outlets, timestamps, source countries — never bodies. Open GDELT terms (unlimited commercial use; citation carried in provenance).
- **world_pulse** — One call: what's happening on Earth RIGHT NOW — the top market mover (majors), a top news headline, the biggest recent earthquake, any major internet outage, the newest actively-exploited CVE, and the fastest AI API — with a plain-English summary. The live state of the world at a glance.

### LLM Pricing & Models (2)

- **ai_models** — Current & trending AI MODELS from the open-model ecosystem (Hugging Face) — name, org, task, popularity (likes/downloads) and release date. Use for 'what AI models are trending / newest / latest <X> model'. The open side (Llama, Qwen, DeepSeek, Mistral, Gemma, Phi); for closed flagships (GPT, Claude, Gemini, Grok) with pricing & versions use search_ai_models.
- **search_ai_models** — Search current AI models by price, context window, and capability. Prices are USD per 1M tokens; results are cheapest-input-price first.

### Live Weather (7)

- **air_quality** — Current air quality for a city or lat/lon — PM2.5, PM10, US & European AQI, ozone, NO2, with a category (Good/Moderate/Unhealthy...). Use for 'is the air quality safe in X'.
- **air_quality_fusion** — Cross-validated air quality — two independent networks reading the same sky: the Open-Meteo CAMS model (the existing air_quality source) vs real ground monitors via OpenAQ v3 (government reference stations), with a per-pollutant (PM2.5, PM10, O3, NO2) agreement verdict (high/moderate/low/divergent), both values + the delta, and station distance/freshness caveats — the two numbers are never blended. location = an AU preset (brisbane default, sydney, melbourne, perth, adelaide), any city name (geocoded), or a 'lat,lon' string; explicit lat/lon override. Complements air_quality (single-network AQI). If one network is down the result degrades honestly to single-source (agreement: 'unverified'). Stations whose licence disallows commercial use are auto-excluded via OpenAQ's machine-readable licence flags; per-station provider attribution + licence carried in provenance.
- **current_weather** — Current weather anywhere — by city name or lat/lon. Returns temperature, feels-like, wind, humidity, precipitation and conditions, live from Open-Meteo. Use instead of guessing the weather.
- **marine_forecast** — Marine / surf forecast for a coastal point — current sea state + next-24-hour outlook. Returns total significant wave height / period / direction, the swell component (long-period energy driving surf), the locally-generated wind-wave, and sea-surface temperature, plus a 24-hour wave-height band. location = AU surf/maritime presets: gold_coast (default), byron, bells_beach, margaret_river, sydney. OR pass lat and lon (decimal degrees) for any coastal point worldwide. Source: Open-Meteo Marine Weather API (CC-BY 4.0). FORECAST data — not a substitute for an official marine forecast/warning.
- **pollen_forecast** — Airborne pollen / allergen forecast — six pollen types (alder, birch, grass, mugwort, olive, ragweed) in grains/m³, each with a plain-English severity band (low / moderate / high / very high), for a hay-fever / asthma / rhinitis audience. Returns the current hour's reading plus the NEXT-DAY peak per type, an overall worst-case level, and a summary naming the dominant allergens. location = city name or preset; EU presets carry real data (london [default], paris, berlin, madrid, rome, amsterdam, vienna, warsaw, athens, dublin), AU/world presets (brisbane, sydney, melbourne, perth, new york, tokyo) are convenience but normally report coverage = out_of_region. Or pass explicit lat + lon. COVERAGE IS EUROPE-ONLY: the CAMS pollen model covers Europe (~4-day forecast in season); outside Europe — including all of Australia, the Americas, Asia, Africa — there is NO pollen model and the response says so honestly (coverage = out_of_region) instead of guessing. DISTINCT from air_quality / air_quality_fusion (those serve POLLUTANTS — PM2.5/ozone/AQI; this serves BIOLOGICAL pollen). Source: Open-Meteo Air Quality API / Copernicus Atmosphere Monitoring Service (CAMS) European ensemble — CC BY 4.0 under Open-Meteo's paid commercial plan (keyless to you); attribution to Open-Meteo + CAMS carried in provenance. Informational only, not medical advice.
- **weather_alerts** — Active US weather warnings, watches & advisories (NWS) for a state/area — severe storms, floods, heat, winter. 'Are there weather alerts in X right now?'
- **weather_forecast** — Multi-day weather forecast (up to 16 days) for a city or lat/lon — daily high/low, precipitation, wind, conditions. Use for 'what's the weather this week / will it rain'.

### Macro (3)

- **au_economy** — Official AUSTRALIAN economic indicators from the Australian Bureau of Statistics Data API (SDMX) — STATISTICS ONLY, NO prices. indicator = cpi (annual inflation, default) | cpi_quarterly | unemployment | wages | gdp. Returns the latest value (a percent), its real ABS reference period (e.g. 2026-Q1 / 2026-04), the unit/description, and a short trend (latest vs prior). CPI annual inflation is DERIVED from the ABS All-groups CPI index (ABS publishes the index, not the annual rate, as its series) — flagged derived:true with the index alongside for checking; unemployment, wage growth (WPI) and GDP growth are ABS's own published rates. Source: Australian Bureau of Statistics (data.api.abs.gov.au), CC BY 4.0; keyless, ~12 h cache (ABS releases monthly/quarterly). HARD CONSTRAINT: every value is an official statistic/index/rate (CPI index, inflation %, unemployment %, wage-growth %, GDP-growth %) — never a market price, quote, FX rate, or asset valuation. Not financial advice.
- **china_data** — China markets & macro that LLMs can't know: Shanghai Composite + Hang Seng indices, A-share & China ETF proxies (CSI 300, MSCI China A50, CSI 500, internet, tech, consumer), CNY/HKD & cross FX, plus 12 World Bank macro series (GDP, growth, CPI, exports/imports, derived trade balance, M2, FDI...). One keyless call for the current state of China's markets & economy.
- **global_macro** — Worldwide macro indicators for ANY country from World Bank Open Data (CC-BY): GDP, growth, GDP/capita, CPI inflation, unemployment, population, trade, current account, reserves, FDI, govt debt. country = ISO code (US, GB, DE) or name; indicator = gdp | gdp_growth | cpi_inflation | unemployment | ... | all.

### Natural Hazards (15)

- **au_water** — Australian river heights + gauge rainfall near any AU location — live CC-BY-licensed gauge observations from the Bureau of Meteorology's Water Data Online (keyless KiWIS API); the Australian counterpart of water_levels (US USGS). Per station: latest river level (m) with a ~3 h rising/falling/steady trend, or rainfall totals (mm over 1/6/24 h ending at the latest reading), plus real observation timestamps + ages, distance, the data owner and the exact attribution string. location = an AU preset (brisbane default, sydney, melbourne, adelaide, hobart, darwin, canberra, perth) or a 'lat,lon' string; explicit lat/lon override. kind = river | rain | both. Only stations whose data owner is CC-BY-listed (Table 1) in the BoM rain/river licensing statement are served — per-station owner attribution carried in provenance, exclusion counts reported, WA coverage honestly partial. Observational data only — not a flood warning product; official flood warnings/watches are issued by the Bureau at bom.gov.au/australia/warnings.
- **climate_enso** — Current El Niño/La Niña state — latest ONI anomaly + phase, official-episode check, recent seasons, and NOAA's alert status (e.g. 'El Niño Watch'). The Pacific driver of global drought/flood/bushfire risk.
- **drought** — US drought severity — % of area in each D0-D4 class by week (U.S. Drought Monitor, keyless). National or by state FIPS.
- **earthquakes** — Recent earthquakes worldwide from USGS — magnitude, depth, location, PAGER impact alert (green→red, distinct from raw magnitude), tsunami flag, felt reports and significance. Use for 'recent/biggest earthquakes' or 'was there a quake near X'. Sorted by impact then magnitude.
- **flood_forecast** — 5-day river-discharge FORECAST near an Australian location — Copernicus CEMS Global Flood Awareness System (GloFAS, operational LISFLOOD control run), retrieved daily from the CEMS Early Warning Data Store and served from cache (the answer is instant — never waits on the CDS queue). The forward-looking sibling of au_water: au_water = what AU rivers are DOING (live gauges), flood_forecast = what the global model expects them to do over the next 5 days. Returns the strongest modelled river cell within ~90 km: 24 h-mean discharge (m3/s) per day for ~5 days, the peak value + day, and a rising/falling/steady trend; values are the MAX within ~25 km (0.25-deg max-pooled) cells. location = an AU preset (brisbane default, sydney, melbourne, adelaide, hobart, darwin, canberra, perth) or a 'lat,lon' string; explicit lat/lon override. Raw model guidance only — no flood thresholds or severity classifications are added, and this is NOT a flood warning; official AU flood warnings/watches are issued by the Bureau of Meteorology at bom.gov.au/australia/warnings. Attribution: contains modified Copernicus Emergency Management Service information.
- **global_disasters** — Active worldwide disaster alerts (GDACS) — ONE cross-hazard feed across earthquakes, tropical cyclones, floods, droughts and volcanoes, each with a Green/Orange/Red humanitarian-impact level and the affected countries. Use for 'what major disasters are happening in the world right now / in country X'. The global severity layer complementing earthquakes, wildfires and natural_events.
- **hurricanes** — Active tropical cyclones from the NOAA National Hurricane Center (NHC) — tropical depressions, tropical storms, and hurricanes. Per storm: name, classification, Saffir-Simpson category, current position (lat/lon), max sustained winds (kt + km/h), minimum pressure, movement (heading + speed), and a link to the latest public advisory and cone graphic. basin = all (default) | atlantic (North Atlantic + Caribbean + Gulf of America) | epac (Eastern + Central North Pacific). Off-season or quiet periods return zero storms — the correct honest state. Source: NOAA NHC (nhc.noaa.gov) — US government public domain (17 U.S.C. § 105), keyless. Coverage: Atlantic + Eastern/Central Pacific ONLY.
- **natural_events** — Active natural events worldwide from NASA EONET — wildfires, severe storms (hurricanes/typhoons), volcanoes, floods, sea/lake ice. Use for 'what natural disasters/events are happening right now'.
- **sea_ice** — Latest daily Arctic + Antarctic sea-ice extent (million km²) from the NSIDC Sea Ice Index (G02135): current extent per pole, change vs the prior week, and the same calendar day ~10 years earlier. NOAA@NSIDC, public domain (citation required).
- **sst_anomaly** — Sea-surface temperature + anomaly for any ocean point or named region (Great Barrier Reef default; Moreton Bay, Tasmania, Ningaloo…), with a marine-heatwave heuristic flag. NOAA OISST v2.1, public domain.
- **tides** — Current water level + next high/low tides for a US coastal station (NOAA CO-OPS, keyless, public domain). Pass a NOAA station id (e.g. 9414290) or a location preset (san francisco, new york, boston, seattle, honolulu, miami, galveston, …). Heights are vs the MLLW datum; units english (feet) or metric. SCOPE: US stations only — not for navigation.
- **uk_water** — Live UK river & water levels and flood warnings from the Environment Agency (England) — real-time gauge readings near a place, each with current level, recent trend (rising / steady / falling), the station's typical range, plus any active EA flood alerts/warnings for the area. location = a UK place name (london, york, oxford, carlisle; default london), OR pass lat/lon (decimal degrees) for any point in England. COVERAGE: England only (the EA's network — not Scotland/Wales/NI). Observational + alert data, not a forecast, and not a substitute for the official GOV.UK flood-warning service for any safety decision. Source: Environment Agency real-time flood-monitoring API — Open Government Licence v3.0 (commercial use with the EA's mandated attribution, carried in provenance), keyless.
- **volcanoes** — Current US volcano alert levels (USGS Volcano Hazards Program, keyless, public domain). 'elevated' (default) returns only volcanoes at YELLOW/ORANGE/RED or ADVISORY/WATCH/WARNING; 'all' returns every USGS-monitored volcano. Each carries the ground alert level, aviation colour code, observatory, when the notice was issued and the official notice URL. SCOPE: US volcanoes only — the global Smithsonian GVP dataset is licensed non-commercial.
- **water_levels** — Real-time US river levels — gage height (ft) + streamflow/discharge (ft3/s) from USGS NWIS (keyless). Flood risk (rising gage) / drought (low flow). By state, USGS site number(s), or a curated set of major rivers.
- **wildfires** — Active US wildfires from NIFC WFIGS — incident name, size in acres, % contained, cause, state and location. The 'how big / how contained' detail satellite hotspot feeds can't give (pairs with natural_events, which has global fire points but not size/containment). Largest first.

### Proprietary (2)

- **ai_provider_latency** — Measured latency & uptime for each major AI provider's API (OpenAI, Anthropic, Google, Mistral, Groq, DeepSeek, xAI) — Dynamic Feed's own measurements, fastest first. Use to pick or route to the fastest/most-reliable provider.
- **service_status** — Live up/down/degraded status for major AI & dev services (OpenAI, Anthropic, GitHub, Cloudflare, etc.). Answers 'is X up right now?'.

### Rates (3)

- **econ_calendar** — What's scheduled to move markets — upcoming US Treasury auctions (type, term, size, date) + FOMC meeting dates with the next meeting. Schedule facts only, never prices. Public-domain US government data.
- **interest_rates** — Live US benchmark interest rates — Effective Fed Funds Rate, SOFR, OBFR, etc. from the New York Fed. Use instead of guessing the current Fed/benchmark rate; training data is stale.
- **treasury_yields** — US Treasury daily par yield curve (1M-30Y) + the 10Y-2Y / 10Y-3M spreads (the classic recession signal), live from the US Treasury. Today's curve is post-cutoff data a model can't know.

### Security (4)

- **check_vulnerability** — Is this exact package (and version) vulnerable? FULL historical lookup across the entire OSV.dev corpus (Google) — every matching advisory plus the versions that fix it. Use to check a dependency, e.g. 'does lodash 4.17.10 have known CVEs?'.
- **exploited_vulnerabilities** — Vulnerabilities CONFIRMED exploited in the wild — the CISA Known Exploited Vulnerabilities (KEV) catalog, each enriched with its EPSS exploitation-probability score (FIRST.org). The 'which CVEs actually matter right now' layer that pairs with security_advisories (disclosed CVEs) and check_vulnerability. Most recently catalogued first.
- **package_health** — Health & security posture of a software package (npm/PyPI/Go/Maven/Cargo/NuGet/RubyGems) from deps.dev (Google Open Source Insights, keyless): latest version, license, known-advisory count, OpenSSF Scorecard (0-10 + weakest checks) and popularity (stars/forks). The 'should I depend on this?' check — pairs with check_vulnerability and software_version.
- **security_advisories** — Recent software security advisories / CVEs — each with the affected package, vulnerable version range, the patched version that fixes it, severity, and CVSS score. Use to check if a package has a recent advisory or to get the latest critical CVEs. Pairs with software_version (is my stack current AND safe?). Covers recently-published reviewed advisories. Source: GitHub Advisory Database.

### Shipping (1)

- **shipping_status** — Global shipping & maritime data: daily ship transits through the world's 28 maritime chokepoints (Suez, Panama, Hormuz, Malacca, Taiwan, Bosporus...) with vessel counts by type — from IMF PortWatch; the ~2,065-port global registry (traffic, top cargo industries, location); and LIVE Baltic vessel positions (real-time AIS) enriched with ship name, type and destination. Use for 'is trade flowing through X / how busy is port Y / what ships are near Z'.

### Software Versions (1)

- **software_version** — Latest stable versions & end-of-life (EOL) dates for software — languages, runtimes, frameworks, databases, OSes (Python, Node.js, PostgreSQL, React, Kubernetes, Ubuntu...). Answers 'what's the latest stable version of X?' and 'is version Y still supported or end-of-life?'. Each result has latest_version, eol_date, and a status (supported/nearing-eol/end-of-life). Source: endoflife.date.

### Space & Orbit (6)

- **orbital_data_centers** — DATA CENTERS IN SPACE — curated registry of compute/AI spacecraft in orbit (Starcloud's NVIDIA H100 GPU, ESA Phi-sat-2 AI edge, D-Orbit in-orbit cloud), each enriched with live orbital data and the speed-of-light round-trip latency floor for ground links. Use for 'what compute/data centers are in space and the latency to reach them'. Unique data.
- **rocket_launches** — Upcoming or recently-launched orbital rocket launches from Launch Library 2 (The Space Devs). Per launch: name, provider (+ type/country), vehicle (+ family/reusability/flight count), pad + location (+ coordinates), net launch time + a live countdown (T-minus / T-plus), net precision + launch window, mission (name/type/orbit/description), and current go/scrub status. window = upcoming (default) | previous (recently launched). limit = how many to return, 1-30 (default 10). Keyless; Launch Library 2 free to use. Schedules slip frequently; trust status + net_precision.
- **satellite_position** — Real-time position of ANY satellite by NORAD id — true SGP4 propagation of the latest live CelesTrak TLE to the current instant: exact latitude/longitude, altitude, velocity, ground-footprint radius, the speed-of-light latency floor, and TLE age. Optionally a forward ground-track. Use for 'where is the ISS / Hubble / satellite X right now'. This is the true propagated position, not an approximation.
- **satellites** — Satellite/constellation catalog (Starlink, GPS, stations…) with each satellite's altitude, orbital period, and a derived speed-of-light round-trip latency to ground — the physics floor for orbital networks / data centers in space.
- **space_weather** — Full space-weather now-cast (NOAA SWPC) — NOAA R/S/G storm scales (radio blackout / radiation storm / geomagnetic storm), geomagnetic Kp index, solar wind (speed, density, Bz — the storm driver), the latest solar X-ray flux/flare, and an aurora-visibility hint. Affects satellite comms & drag, GPS, HF radio, power grids, and orbital-compute radiation/power. Use for 'is there a geomagnetic/solar storm right now'.
- **spacex** — Live SpaceX activity — next & recent SpaceX launches + Starlink constellation size, from public data; not financial/stock data. A single composite digest answering "what is SpaceX doing right now": the next SpaceX launches and the most recent ones (name, vehicle, pad, net launch time + live countdown, go/scrub status), plus the size of the Starlink constellation we track (object count + a couple of sample objects). Argless. INDEPENDENT — not affiliated with or endorsed by SpaceX; "SpaceX"/"Starlink" used descriptively only. Reuses two feeds we already serve (no new upstream): rocket_launches (Launch Library 2, The Space Devs) filtered to the SpaceX provider, and satellites(group=starlink) off our CelesTrak TLE mirror — so it does not hammer upstreams on the request path. Each part degrades independently. HARD CONSTRAINT: no stock price, share price, valuation, or IPO/investment data of any kind — launch schedule + constellation facts only, informational, from public data (The Space Devs, CelesTrak).

### Sports & Events (2)

- **sports_pulse** — Global ATTENTION + official schedule for a sporting event, team or competition — e.g. the 2026 FIFA World Cup. Daily Wikipedia views by language edition (momentum/peak) + hosts/dates/sport from Wikidata. Wikimedia + Wikidata (CC0); NOT live scores, fixtures or odds.
- **world_cup** — 2026 FIFA World Cup — official fixtures and final results for all 104 matches (group stage to final), with kickoff times, venues, teams and post-match scores. Source: openfootball (public domain). Results post-match, NOT live in-play scores.

### biodiversity (1)

- **species_occurrences** — Recent species occurrence records from GBIF (Global Biodiversity Information Facility) — individual field observations and museum specimens of where/when a species has been recorded. Each record: species + scientific name, lat/lon, date, country, source dataset (+ GBIF citation), recorder, and basis-of-record. query = a common name (koala, great white shark, platypus) or scientific name (Phascolarctos cinereus). near = lat,lon to restrict to records within ~100 km of that point. Keyless GBIF.org API; filtered to CC0 + CC BY 4.0 only (CC BY-NC excluded). OCCURRENCE data — not a population census or range map.

### bitcoin (2)

- **bitcoin_network** — Live Bitcoin NETWORK telemetry — infrastructure metrics only, NO price data. metric = overview (default, full digest) | fees (recommended fee tiers sat/vB) | mempool (unconfirmed tx count + vsize + pending fees) | difficulty (current + next adjustment % + blocks until retarget) | hashrate (3-day average EH/s) | halving (blocks remaining + estimated date + current/post-halving block subsidy). Source: mempool.space public REST API (AGPL-3.0) + Blockstream Esplora (MIT) fallback. Keyless, 60 s cache. No BTC/USD or fiat price — Bitcoin NETWORK mechanics only.
- **lightning_network** — Bitcoin LIGHTNING NETWORK aggregate statistics — network infrastructure metrics only, NO price data. Returns node count, public channel count, total public channel capacity (in BTC and satoshis), average + median channel capacity, the Tor / clearnet / unannounced node split, and the average fee rate (ppm) — plus a human summary and the snapshot date. Lightning is Bitcoin's layer-2 payment network; these are its routing/topology metrics. Source: mempool.space public REST API (open-source Bitcoin explorer, AGPL-3.0). Keyless, ~10 min cache. Capacity is a NETWORK metric in BTC/sats — never a fiat valuation or market price.

### ocean (1)

- **ocean_buoys** — Live marine observations from NOAA NDBC ocean buoys — significant wave height & period, wave direction, wind speed/direction/gust, barometric pressure (+ 3-hour tendency), air & water temperature, dewpoint and visibility, each with the buoy's own observation timestamp + age. station = an NDBC station id (e.g. 46059, 51001, 41001). near = lat,lon string (e.g. 37.7,-123.0) or a coast preset (us west coast, us east coast, gulf of mexico, hawaii, alaska, great lakes, pacific nw, new england, florida, california, korea). No args = a default open-ocean buoy. NOAA NDBC — US government public domain, keyless.

### research (2)

- **research_papers** — Latest scholarly preprints from arXiv — newest-first — by category and/or keyword. Returns up to 15 papers with: title, authors, truncated abstract, primary + all categories, published/updated dates, arXiv id, abstract URL, PDF URL, and DOI / journal reference when a published version exists. category = arXiv taxonomy term (default cs.AI). Common: cs.AI, cs.LG (ML), cs.CL (NLP/LLMs), cs.CV (CV), cs.RO (Robotics), cs.CR (Security), stat.ML, cs.MA. query = optional keyword, AND-combined with category. Source: arXiv API (CC0 1.0, keyless, commercial OK). arXiv is a PREPRINT server; most papers are not peer-reviewed.
- **scholarly_search** — Fact-check the published scholarly record via OpenAlex — METADATA ONLY, NO prices. query = free text/topic ("CRISPR gene editing") OR a DOI / doi.org URL for an exact-work lookup. sort = relevance (default) | citations | newest | oldest. limit = max works (default 10, cap 25). Each work returns its citation count, open-access status + URL, publication venue + type, year/date, work type, lead authors (up to 5) + total author count + lead institution, references count, retraction flag, and the work's own OpenAlex record-update time. Spans 240M+ works across every publisher (journals, conferences, books, datasets, preprints), so it answers does this paper exist / how cited is it / is it open access / where was it published / who wrote it — which a training snapshot gets stale or hallucinates. DISTINCT from research_papers (arXiv preprints only, newest-first abstracts): different source (OpenAlex), cross-publisher, citation/OA/venue metadata — no abstracts, no full text. Source: OpenAlex (api.openalex.org, OurResearch), data is CC0 1.0 public domain; keyless (polite pool), ~6 h cache. HARD CONSTRAINT: every value is bibliometric metadata (a citation count, year, OA status, venue, author) — never a market price, quote, or valuation.

## Examples (copy-paste)

```bash
# what's around this vehicle / robot / location right now? (signed, keyless)
curl "https://dynamicfeed.ai/v1/nearby?lat=-12.46&lon=130.84&radius_km=300"

# was the parametric trigger hit? (signed receipt, keyless)
curl "https://dynamicfeed.ai/v1/trigger-receipt?metric=wind_kmh&op=gte&threshold=120&lat=-19.26&lon=146.82"

# notarize your own data feed (free key: POST /signup)
curl -X POST https://dynamicfeed.ai/v1/notarize -H "X-API-Key: $KEY" \
  -H "content-type: application/json" -d '{"payload": {"my_reading": 42.1}, "subject": "Acme Sensors"}'
```

Contact: hello@dynamicfeed.ai · Pricing: https://dynamicfeed.ai/#pricing · Docs: https://dynamicfeed.ai/docs