{"openapi":"3.1.0","info":{"title":"OpenStream Pricing Data API","version":"2026-11-08.live","description":"Fresh, provenance-tagged utility pricing with the source and date on every figure, in four walled markets that never mix: Australia (AUD: nbn, mobile, energy, catalogue, health, business-insurance, deals); United Kingdom (GBP: broadband); New Zealand (NZD: broadband); United States (USD: electricity). Open margin is provided only where a genuine public wholesale reference exists (Australian NBN, energy); never estimated. The /api/v1/tools/{tool} operations are the MCP server's tools over REST; each answer carries the tool's markdown text and its structured result, and every row that can be acted on carries a hand-off URL through OpenStream's /go page.","contact":{"name":"OpenStream","url":"https://openstream.com.au"}},"servers":[{"url":"https://openstream.com.au","description":"Production"}],"paths":{"/api/v1/plans":{"get":{"operationId":"getPlans","summary":"List/filter current utility plans","description":"Call this to find plans matching a user's constraints. Filter by vertical (nbn|mobile|energy), provider, segment (residential|small_business|enterprise), zone_or_tech, min_speed (Mbps), max_price (AUD/mo). Use as_of=ISO for a point-in-time (valid-time) view. verbosity=full returns attributes + reputation.","parameters":[{"name":"vertical","in":"query","required":false,"schema":{"type":"string"},"description":"One of nbn, mobile, energy"},{"name":"provider","in":"query","required":false,"schema":{"type":"string"},"description":"Provider id or brand name, e.g. cmp-aussie-broadband or 'Aussie Broadband'"},{"name":"segment","in":"query","required":false,"schema":{"type":"string"},"description":"residential | small_business | enterprise"},{"name":"speed","in":"query","required":false,"schema":{"type":"string"},"description":"Advertised download band in Mbps: 12, 25, 50, 100, 250, 400, 500, 750, 1000, 2000"},{"name":"connection","in":"query","required":false,"schema":{"type":"string"},"description":"fixed_line (FTTP/HFC/FTTC/FTTN) | fixed_wireless | satellite | any (default any)"},{"name":"sort","in":"query","required":false,"schema":{"type":"string"},"description":"price | margin | margin_pct (ascending)"},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"Page size, default 100, max 1000 - use 20 or less for chat answers"},{"name":"offset","in":"query","required":false,"schema":{"type":"string"},"description":"Pagination offset; the response's next_offset gives the next page"},{"name":"zone_or_tech","in":"query","required":false,"schema":{"type":"string"},"description":"Energy distribution zone or NBN technology (e.g. FTTP)"},{"name":"min_speed","in":"query","required":false,"schema":{"type":"string"},"description":"Minimum typical evening speed in Mbps (NBN)"},{"name":"max_price","in":"query","required":false,"schema":{"type":"string"},"description":"Maximum monthly price in AUD (ignored for quote-priced plans)"},{"name":"as_of","in":"query","required":false,"schema":{"type":"string"},"description":"ISO-8601 date for a point-in-time price (bitemporal valid-time)"},{"name":"verbosity","in":"query","required":false,"schema":{"type":"string"},"description":"summary (default) or full"}],"responses":{"200":{"description":"A page of plans (total, count, next_offset), each with price, margin (where available), citation incl. price_last_confirmed_at","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/answers":{"get":{"operationId":"listAnswers","summary":"Index of ready-made answers (slugs)","description":"Lists every answer slug: cheapest-nbn-{speed}, lowest-margin-nbn-{speed}, {provider}-nbn-plans, {a}-vs-{b}-nbn, nbn-price-changes-this-week, nbn-price-rises-this-month, nbn-price-drops-this-month. Call it to find the right slug for a provider or comparison, then call getAnswer.","responses":{"200":{"description":"answers: [{slug, title, group, url, page_url}]","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/answers/{slug}":{"get":{"operationId":"getAnswer","summary":"A compact, dated answer to a common pricing question","description":"Preferred for chat: returns a plain-language summary plus the ranked plans (price inc GST, promo, estimated margin where a public wholesale reference exists, price_last_confirmed_at, page_url to cite). Slugs: cheapest-nbn-100, lowest-margin-nbn-1000, aussie-broadband-nbn-plans, tpg-vs-aussie-broadband-nbn, nbn-price-changes-this-week, nbn-price-rises-this-month. Unknown slug => 404 with how_to_resolve.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Answer slug"}],"responses":{"200":{"description":"answer: {title, question, summary, as_of, dataset_version, plans[], bullets[], related[], page_url}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/plans/{id}":{"get":{"operationId":"getPlan","summary":"Get one plan with full detail + provenance","description":"Fetch a single plan by product_id with attributes, rates, fees, bitemporal timestamps, reputation components, and the citation object for verification.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"product_id"},{"name":"as_of","in":"query","required":false,"schema":{"type":"string"},"description":"ISO point-in-time"}],"responses":{"200":{"description":"A single plan","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/plans/{id}/history":{"get":{"operationId":"getPlanHistory","summary":"Price-over-time history for a plan","description":"Returns every observed price version and the change-sets that moved it (prior->new values, both raw-snapshot refs). Use to answer 'did this plan get worse since I signed up'.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"product_id"}],"responses":{"200":{"description":"Version + change history","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/changes":{"get":{"operationId":"getChangesSince","summary":"All pricing changes since a timestamp","description":"The diff-first change feed. Pass since=ISO. Over-threshold changes are marked pending_human_review and the prior value keeps serving until confirmed.","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string"},"description":"ISO-8601 timestamp (required)"}],"responses":{"200":{"description":"A list of change-sets","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/margin":{"get":{"operationId":"getMargin","summary":"Open retail-vs-wholesale margin for a plan","description":"Returns margin = retail - wholesale where a public wholesale reference exists (NBN SAU tariff, energy cost stack). For mobile / quote-priced plans returns margin_available:false with a reason - never an estimated number.","parameters":[{"name":"product_id","in":"query","required":false,"schema":{"type":"string"},"description":"product_id (required)"}],"responses":{"200":{"description":"Margin or an explicit unavailable reason","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/address":{"get":{"operationId":"checkAddress","summary":"NBN Co address lookup: suggestions for a street address, or the connection type for one premises","description":"Call with q=<street address with suburb and state> to get NBN Co's matching premises [{id, address}]; then call with id=<LOC…> to get the connection technology (FTTP, HFC, FTTC, FTTN, FTTB, WIRELESS, SATELLITE), its label and the highest fixed-line tier it supports (maxTier). The technology decides which plans can be ordered: pass min/max speed to getPlans accordingly, and link the user to /switch?loc=<id>&tech=<tech>&addr=<address>&new=1. No key; 240 lookups per IP per hour; 503 with how_to_resolve when NBN Co does not answer.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Street address to match (min 4 chars)"},{"name":"id","in":"query","required":false,"schema":{"type":"string"},"description":"NBN Co location id (LOC…) from a suggestion"}],"responses":{"200":{"description":"{suggestions:[{id,address}]} for q, {detail:{id,address,tech,techLabel,maxTier,fttpUpgrade,locality}} for id","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/zones":{"get":{"operationId":"resolveZone","summary":"Resolve a postcode to an energy distribution zone","description":"Energy pricing is zone-keyed. Call this first with a user's postcode to get the distribution_zone to pass as zone_or_tech to getPlans.","parameters":[{"name":"postcode","in":"query","required":false,"schema":{"type":"string"},"description":"4-digit AU postcode (required)"}],"responses":{"200":{"description":"A zone resolution","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/calculator":{"get":{"operationId":"estimateAnnualCost","summary":"Neutral annual-cost estimate for an energy plan","description":"Arithmetic on published rates + a usage profile (defaults to AER benchmark). Returns a full breakdown and the formula. A calculation, not a recommendation.","parameters":[{"name":"product_id","in":"query","required":false,"schema":{"type":"string"},"description":"energy product_id (required)"},{"name":"annual_kwh","in":"query","required":false,"schema":{"type":"string"},"description":"Annual usage in kWh (default 4000)"},{"name":"peak_fraction","in":"query","required":false,"schema":{"type":"string"},"description":"Share of usage in peak window (default 0.45)"},{"name":"offpeak_fraction","in":"query","required":false,"schema":{"type":"string"},"description":"Share of usage off-peak (default 0.55)"},{"name":"shoulder_fraction","in":"query","required":false,"schema":{"type":"string"},"description":"Share of usage in a mid-day shoulder/solar-soak window (VIC 3-period TOU; default 0)"}],"responses":{"200":{"description":"An annual cost estimate with breakdown","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/find_plans":{"get":{"operationId":"find_plans","summary":"Find plans (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Search current Australian NBN and mobile plans by provider, speed band, segment and price cap (electricity plans: use recommend_electricity, cheapest_electricity or search, which carry page_url per plan). Default vertical nbn, sorted cheapest first. Returns a compact table plus structured rows with price_last_confirmed_at and page_url. changed_since narrows to plans whose price or details moved in a window (e.g. '30d').","tags":["Australia"],"parameters":[{"name":"vertical","in":"query","required":false,"description":"","schema":{"type":"string","enum":["nbn","mobile","energy"]}},{"name":"provider","in":"query","required":false,"description":"Brand name or provider_id, e.g. 'Aussie Broadband' or 'cmp-tpg'","schema":{"type":"string"}},{"name":"speed","in":"query","required":false,"description":"Advertised download band in Mbps: 12, 25, 50, 100, 250, 400, 500, 750, 1000 or 2000","schema":{"type":"integer"}},{"name":"segment","in":"query","required":false,"description":"","schema":{"type":"string","enum":["residential","small_business","enterprise"]}},{"name":"max_price","in":"query","required":false,"description":"Max ongoing monthly price in AUD inc GST","schema":{"type":"number"}},{"name":"sort","in":"query","required":false,"description":"","schema":{"type":"string","enum":["price","margin","margin_pct"]}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 25","schema":{"type":"integer","minimum":1,"maximum":25}},{"name":"as_of","in":"query","required":false,"description":"ISO date for point-in-time pricing","schema":{"type":"string"}},{"name":"connection","in":"query","required":false,"description":"Default any","schema":{"type":"string","enum":["fixed_line","fixed_wireless","satellite","any"]}},{"name":"changed_since","in":"query","required":false,"description":"Only plans with a recorded change since: ISO-8601 timestamp or relative window 1d, 7d, 30d","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/find_mobile_plans":{"get":{"operationId":"find_mobile_plans","summary":"Find mobile plans (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. SIM-only Australian mobile plans read every hour from each brand's own page, cheapest first: price, included data, the network the brand runs on, and whether the plan is sold per month or per recharge period (prepaid). Filter by minimum data, network, prepaid. A price per recharge is not a monthly price; period_days says which.","tags":["Australia"],"parameters":[{"name":"min_gb","in":"query","required":false,"description":"Only plans with at least this much data, in GB","schema":{"type":"number"}},{"name":"network","in":"query","required":false,"description":"The network the plan runs on, including resellers","schema":{"type":"string","enum":["telstra","optus","vodafone"]}},{"name":"prepaid","in":"query","required":false,"description":"true: only plans sold per recharge; false: only monthly plans","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 25","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/roaming_plans":{"get":{"operationId":"roaming_plans","summary":"Travel eSIM plans for a destination (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Travel eSIM plans for Australians going overseas, read nightly from Holafly, Airalo, Maya Mobile and Nomad: destination, data (or unlimited), validity in days, the provider's price in its own currency, and the AUD equivalent at the Reserve Bank of Australia's rate for the day (the rate is returned). Ranked by AUD per day of validity. Destinations: japan, indonesia, new-zealand, united-states, united-kingdom, thailand, vietnam, fiji, singapore, india, china, italy, france, philippines, malaysia, south-korea, hong-kong, greece, spain, united-arab-emirates, europe, canada, germany, switzerland, croatia, turkey, portugal, netherlands, ireland, cambodia, sri-lanka, taiwan, nepal, mexico, peru, egypt, south-africa.","tags":["Australia"],"parameters":[{"name":"destination","in":"query","required":true,"description":"Destination slug, e.g. japan, indonesia, new-zealand, united-states, europe","schema":{"type":"string"}},{"name":"min_days","in":"query","required":false,"description":"Only plans valid for at least this many days","schema":{"type":"integer"}},{"name":"unlimited","in":"query","required":false,"description":"true: unlimited-data plans only","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 25","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/smartwatch_plans":{"get":{"operationId":"smartwatch_plans","summary":"Smartwatch plans (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. The cellular add-ons the three Australian carriers sell for an Apple Watch, Galaxy Watch or Pixel Watch: monthly price, what it does, the phone plan it requires, and where the price was read.","tags":["Australia"],"parameters":[],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/cheapest_plan":{"get":{"operationId":"cheapest_plan","summary":"Cheapest plan for a speed (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. The cheapest ongoing price for an NBN speed band today, plus the best intro deal if different. Use when the user asks 'cheapest NBN 100' style questions.","tags":["Australia"],"parameters":[{"name":"speed","in":"query","required":true,"description":"Advertised download band in Mbps: 12, 25, 50, 100, 250, 400, 500, 750, 1000 or 2000","schema":{"type":"integer"}},{"name":"segment","in":"query","required":false,"description":"","schema":{"type":"string","enum":["residential","small_business","enterprise"]}},{"name":"provider","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"connection","in":"query","required":false,"description":"Default fixed_line - Fixed Wireless and satellite are different products","schema":{"type":"string","enum":["fixed_line","fixed_wireless","satellite","any"]}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/compare_plans":{"get":{"operationId":"compare_plans","summary":"Compare plans (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Side-by-side comparison of 2-6 plans by product_id (from find_plans).","tags":["Australia"],"parameters":[{"name":"product_ids","in":"query","required":true,"description":"(comma-separated)","schema":{"type":"string","description":"comma-separated values"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/get_plan":{"get":{"operationId":"get_plan","summary":"Plan detail with provenance (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Full detail for one plan: price basis, ex-GST price, wholesale reference and margin basis, per-source prices, every citation with captured/last-confirmed timestamps, and the history page.","tags":["Australia"],"parameters":[{"name":"product_id","in":"query","required":true,"description":"","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/check_address":{"get":{"operationId":"check_address","summary":"Check an address (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. What NBN plans a street address can actually get. Runs NBN Co's address lookup (no key required; the address is not kept as a record, though the suburb and a one-way hash of it appear in operational logs for up to 30 days): the connection technology (FTTP, HFC, FTTC, FTTN, FTTB, Fixed Wireless, Sky Muster satellite) decides which plans can be ordered (copper tails top out at NBN 100; Fixed Wireless and satellite have their own plans). max_tier_mbps is the ceiling for that TECHNOLOGY, not a measurement of the individual line: every FTTP premises reports 2000. Treat it as the highest tier worth offering, confirm the real limit with the supplier, and check fttp_upgrade where a premises is only eligible after an upgrade. Returns the matched premises, the technology, the eligible plans cheapest first, and a link that opens OpenStream with the address already resolved. When several premises match (units, duplicates), it lists them with ids: call again with location_id. Give the full street address with suburb and state, e.g. '35 Moorhouse St, Camberwell VIC'.","tags":["Australia"],"parameters":[{"name":"address","in":"query","required":true,"description":"Street address with suburb and state","schema":{"type":"string"}},{"name":"location_id","in":"query","required":false,"description":"NBN Co location id from a previous ambiguous result, to pick one premises","schema":{"type":"string"}},{"name":"speed","in":"query","required":false,"description":"Only plans on this download band; default every band the line supports","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 25","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/cheapest_electricity":{"get":{"operationId":"cheapest_electricity","summary":"Cheapest electricity by postcode (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Electricity plans a postcode can get, cheapest first. The postcode's distribution network decides the prices; every published plan on that network (the regulator's Energy Made Easy listings, re-read nightly) is costed at a stated annual usage from its own supply charge and rates: a representative monthly estimate, not a quote. Variable-priced (wholesale-linked) plans and demand-tariff plans are shown without an estimate. Each plan carries the regulator's record link; the postcode page lists the same plans with the full rate card. Victoria and the NEM states only.","tags":["Australia"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"4-digit Australian postcode","schema":{"type":"string"}},{"name":"annual_kwh","in":"query","required":false,"description":"Annual usage in kWh; default 4000 (4,000 kWh a year (a typical household)); 2000 = 2,000 kWh a year (one or two people); 6000 = 6,000 kWh a year (a large household)","schema":{"type":"integer","minimum":500,"maximum":30000}},{"name":"solar","in":"query","required":false,"description":"Household has rooftop solar (keeps solar-only plans in)","schema":{"type":"boolean"}},{"name":"battery","in":"query","required":false,"description":"Household has a battery","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 40","schema":{"type":"integer","minimum":1,"maximum":40}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/electricity_network":{"get":{"operationId":"electricity_network","summary":"Electricity network market (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. One electricity distribution network's market (Ausgrid, Endeavour Energy, Essential Energy, Energex, Ergon Energy, SA Power Networks, CitiPower, Powercor, Jemena, United Energy, AusNet Services, Evoenergy, TasNetworks): the regulator's reference price (DMO/VDO) against our cheapest and median at the same benchmark usage, the cheapest plans at the typical profile, and what moved since yesterday. Use when the user names a network or a state rather than a postcode.","tags":["Australia"],"parameters":[{"name":"network","in":"query","required":true,"description":"Network name or slug, e.g. 'Ausgrid', 'sa-power-networks'","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Cheapest plans to list; default 10","schema":{"type":"integer","minimum":1,"maximum":40}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/recommend_electricity":{"get":{"operationId":"recommend_electricity","summary":"Recommend electricity plans (what the site shows) (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. The electricity recommendation openstream.com.au itself makes for a postcode: the cheapest published plan, the cheapest from a large well-known retailer, and the simplest single-rate plan with no conditional discounts, each costed at the person's annual kWh from the retailer's published rates, with a page_url to cite. Give current_monthly_bill when they have told you what they pay so the saving is against their real bill; otherwise it is against the median published plan at that usage, and the result says so. The regulator's reference price (DMO/VDO) for the network is returned beside the picks. Follow with electricity_signup_link for the plan they choose. NSW, VIC, QLD, SA, ACT and TAS.","tags":["Australia"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"4-digit Australian postcode","schema":{"type":"string"}},{"name":"annual_kwh","in":"query","required":false,"description":"kWh a year from their bill (a quarterly bill x4); default 4000","schema":{"type":"integer","minimum":500,"maximum":30000}},{"name":"current_monthly_bill","in":"query","required":false,"description":"What they pay now, AUD a month (a quarterly bill / 3)","schema":{"type":"number","minimum":20,"maximum":2000}},{"name":"solar","in":"query","required":false,"description":"Household has rooftop solar","schema":{"type":"boolean"}},{"name":"battery","in":"query","required":false,"description":"Household has a battery","schema":{"type":"boolean"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/electricity_signup_link":{"get":{"operationId":"electricity_signup_link","summary":"Get the sign-up link for an electricity plan (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. The link to give the person once they have chosen an electricity plan: OpenStream's hand-off page (it shows the plan and the estimate), then the retailer to sign up - the same path a visitor to openstream.com.au takes, carrying a one-off reference so the sign-up can be attributed back to this conversation. Where no retailer link is held it goes to the regulator's record for the plan, which carries the retailer's own sign-up link. Get plan_id from recommend_electricity or cheapest_electricity.","tags":["Australia"],"parameters":[{"name":"plan_id","in":"query","required":true,"description":"Plan id from recommend_electricity / cheapest_electricity (the regulator's id, e.g. AGL123456MRE1)","schema":{"type":"string"}},{"name":"brand","in":"query","required":false,"description":"Retailer name, when known; speeds the lookup","schema":{"type":"string"}},{"name":"assistant","in":"query","required":false,"description":"Which assistant is asking (chatgpt, claude, ...); detected from the client when omitted","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/recommend_plans":{"get":{"operationId":"recommend_plans","summary":"Recommend plans (what the site shows) (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. The recommendation openstream.com.au itself makes for a speed tier, with the same arithmetic: the cheapest ongoing price, the lowest first-year cost (intro months at the promo price, then the ongoing price), the cheapest well-known brand, and a faster tier that still costs no more than the current bill. Give current_monthly_price when the person has told you what they pay - savings are then measured against their real bill instead of the tier average. Pass max_tier from check_address so a faster pick is never one the line cannot carry. Follow with signup_link for the pick they choose.","tags":["Australia"],"parameters":[{"name":"speed","in":"query","required":true,"description":"Tier to compare: 25, 50, 100, 250, 500, 1000. Ask if unsure; 100 suits most households","schema":{"type":"integer"}},{"name":"current_monthly_price","in":"query","required":false,"description":"What they pay now, AUD a month inc GST","schema":{"type":"number","minimum":10,"maximum":500}},{"name":"max_tier","in":"query","required":false,"description":"Highest tier the line supports, from check_address (FTTN/FTTB/FTTC = 100)","schema":{"type":"integer"}},{"name":"segment","in":"query","required":false,"description":"","schema":{"type":"string","enum":["residential","small_business"]}},{"name":"connection","in":"query","required":false,"description":"Default fixed_line","schema":{"type":"string","enum":["fixed_line","fixed_wireless","satellite","any"]}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/signup_link":{"get":{"operationId":"signup_link","summary":"Get the sign-up link for a plan (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. The link to give the person once they have chosen a plan. It opens OpenStream's hand-off page, which shows the price and the date it was confirmed on the provider's own site, then sends them to the provider to sign up - the same path a visitor to openstream.com.au takes. The link carries a one-off reference so the sign-up can be attributed back to this conversation; a URL you build yourself loses that, so always use this tool rather than linking the provider directly. Nothing is bought here and the person is never charged by OpenStream. Get product_id from recommend_plans, find_plans or cheapest_plan.","tags":["Australia"],"parameters":[{"name":"product_id","in":"query","required":true,"description":"Plan id from recommend_plans / find_plans / cheapest_plan","schema":{"type":"string"}},{"name":"assistant","in":"query","required":false,"description":"Which assistant is asking (chatgpt, claude, ...); detected from the client when omitted","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/plan_history":{"get":{"operationId":"plan_history","summary":"Plan price history (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. One plan's price over time: every observed price version with its dated page, and every change that moved it (prior -> new values, source, both raw snapshot refs, pending-review flag). Use after find_plans for a product_id.","tags":["Australia"],"parameters":[{"name":"product_id","in":"query","required":true,"description":"","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/plan_changes":{"get":{"operationId":"plan_changes","summary":"What changed (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Price and plan changes recorded by the hourly index since a date (ISO) or a relative window like '7d'. Optional provider filter.","tags":["Australia"],"parameters":[{"name":"since","in":"query","required":true,"description":"ISO-8601 timestamp or relative window: 1d, 7d, 30d","schema":{"type":"string"}},{"name":"provider","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/lookup_provider":{"get":{"operationId":"lookup_provider","summary":"Provider lookup (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Find a tracked provider by name: registry status, how many plans are served, cheapest price, and last night's index outcome.","tags":["Australia"],"parameters":[{"name":"query","in":"query","required":true,"description":"","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/search":{"get":{"operationId":"search","summary":"Search OpenStream (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Full-text search over tracked plans and providers. Returns ids for fetch.","tags":["Australia"],"parameters":[{"name":"query","in":"query","required":true,"description":"","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/fetch":{"get":{"operationId":"fetch","summary":"Fetch a plan record (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. Fetch the full record for an id returned by search.","tags":["Australia"],"parameters":[{"name":"id","in":"query","required":true,"description":"","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/uk_broadband_plans":{"get":{"operationId":"uk_broadband_plans","summary":"UK broadband plans (United Kingdom, GBP)","description":"Market: United Kingdom; currency GBP; Broadband plans read from each provider's own page and re-confirmed daily, ranked on what the contract costs a month once the provider's published mid-contract rises are counted. UNITED KINGDOM broadband (GBP, VAT included; a separate market from Australia, never mixed). Plans read from each provider's own page and re-confirmed daily, ranked on what the contract costs a month once the provider's own published mid-contract rises are counted (Ofcom bans inflation-linked rises, so every rise is a pounds figure quoted from the page). Each row: advertised price, contract average, the rises with their dates, speed and its basis, the day the price was last confirmed, the provider page and a sign-up hand-off. postcode applies the plans' stated area limits (Hull, Wales, Scotland...) via the council district; whether a network passes the door is the provider's checker to answer, and the result says so. Read date: per row, price_confirmed_at.","tags":["United Kingdom"],"parameters":[{"name":"min_mbps","in":"query","required":false,"description":"Only plans of at least this download speed in Mbps (plan or average speed as the page states it)","schema":{"type":"integer","minimum":1}},{"name":"kind","in":"query","required":false,"description":"","schema":{"type":"string","enum":["full fibre","part fibre","cable","wireless"]}},{"name":"postcode","in":"query","required":false,"description":"A UK postcode, e.g. SW1A 1AA: rules out plans whose stated area excludes it","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 40","schema":{"type":"integer","minimum":1,"maximum":40}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/nz_broadband_plans":{"get":{"operationId":"nz_broadband_plans","summary":"NZ broadband plans (New Zealand, NZD)","description":"Market: New Zealand; currency NZD; Broadband plans read from each retailer's own page and re-confirmed daily, ranked on the ongoing price after any promotion. NEW ZEALAND broadband (NZD, GST included; a separate market from Australia, never mixed). Plans read from each retailer's own page and re-confirmed daily, ranked on the ongoing monthly price; a promotion is shown beside it in the retailer's words and never ranks. Each row: ongoing price, promotion, the retailer's own average-monthly figure where it publishes one, speed and its basis, connection kind, the day the price was last confirmed, the retailer page and a sign-up hand-off. Read date: per row, price_confirmed_at.","tags":["New Zealand"],"parameters":[{"name":"min_mbps","in":"query","required":false,"description":"Only plans of at least this download speed in Mbps","schema":{"type":"integer","minimum":1}},{"name":"kind","in":"query","required":false,"description":"","schema":{"type":"string","enum":["fibre","hyperfibre","wireless","vdsl"]}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 40","schema":{"type":"integer","minimum":1,"maximum":40}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/us_electricity_plans":{"get":{"operationId":"us_electricity_plans","summary":"US electricity plans by state (United States, USD)","description":"Market: United States; currency USD; Electricity offers from each launched state's regulator feed (Texas: the PUCT's Power to Choose export, read daily), ranked on the average price per kWh at a stated monthly usage in the offer's delivery zone. UNITED STATES retail electricity (USD; a separate market, never mixed), one launched state at a time: today Texas (TX), Pennsylvania (PA), Ohio (OH); any other state answers that it is not priced. Every offer the state regulator's feed lists (Texas: the PUCT's Power to Choose export, read daily), with the average price in cents per kWh at 500, 1,000 and 2,000 kWh exactly as the feed states it, term, rate type, renewable share, prepaid and time-of-use flags, any bill-credit or minimum-usage condition, the regulator's facts label (the document to cite), the offer's page and an enrolment hand-off. Give a ZIP (the counties' delivery utilities decide the zone) or a utility name; with neither the answer is the cheapest offer per zone. usage_kwh picks which of the three points ranks. OpenStream is not registered as a broker in any state and earns nothing from any US retailer. Read date: as_of and per row read_at.","tags":["United States"],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter state code, e.g. TX","schema":{"type":"string"}},{"name":"zip","in":"query","required":false,"description":"Five-digit ZIP; resolves the delivery utility zone(s) from Census and EIA-861 files","schema":{"type":"string"}},{"name":"utility","in":"query","required":false,"description":"Delivery utility (zone) name or id, e.g. 'Oncor', 'centerpoint'","schema":{"type":"string"}},{"name":"usage_kwh","in":"query","required":false,"description":"Monthly usage point to rank on; default 1000","schema":{"type":"number","enum":["500","1000","2000"]}},{"name":"term_months","in":"query","required":false,"description":"Only offers with this contract term; 0 is the feed's word for no fixed term","schema":{"type":"integer","minimum":0,"maximum":60}},{"name":"rate_type","in":"query","required":false,"description":"","schema":{"type":"string","enum":["fixed","variable","indexed"]}},{"name":"renewable_only","in":"query","required":false,"description":"Only 100% renewable offers","schema":{"type":"boolean"}},{"name":"prepaid","in":"query","required":false,"description":"true: prepaid offers only; false: exclude them","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 40","schema":{"type":"integer","minimum":1,"maximum":40}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/health_cover_options":{"get":{"operationId":"health_cover_options","summary":"Australian health cover options (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. AUSTRALIA private health insurance (AUD). The cheapest open policies for a state, household and cover kind from the regulator's monthly release (PrivateHealth.gov.au, every policy with its published monthly premium before the government rebate), cheapest first, funds anyone can join by default. Each row: fund, policy, tier (gold, silver-plus, silver, bronze-plus, bronze, basic-plus, basic), premium before rebate, excess, Medicare Levy Surcharge exemption, the policy page (what it covers, waiting periods, premium after each rebate band), the fund's page and a hand-off to the fund. This ranks published premiums; it is not advice. Read date: the release day (release).","tags":["Australia"],"parameters":[{"name":"state","in":"query","required":true,"description":"State; the ACT is under NSW in the release","schema":{"type":"string","enum":["NSW","VIC","QLD","SA","WA","TAS","NT"]}},{"name":"scale","in":"query","required":false,"description":"Household: single (default), couple, family, single_parent","schema":{"type":"string","enum":["single","couple","family","single_parent"]}},{"name":"kind","in":"query","required":false,"description":"hospital (default), extras only, or hospital and extras combined","schema":{"type":"string","enum":["hospital","extras","combined"]}},{"name":"tier","in":"query","required":false,"description":"Hospital tier slug: gold, silver-plus, silver, bronze-plus, bronze, basic-plus, basic; omit for every tier","schema":{"type":"string"}},{"name":"open_funds_only","in":"query","required":false,"description":"Default true: only funds anyone can join (restricted funds left out)","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Default 10, max 40","schema":{"type":"integer","minimum":1,"maximum":40}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/business_insurance_check":{"get":{"operationId":"business_insurance_check","summary":"Business insurance check (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. AUSTRALIA business insurance: NOT a price comparison and never will be (business cover is underwritten per risk and no Australian regulator publishes premiums), so this returns NO figure of any kind. For a kind of business, in whatever word the person used (builder, cafe, barber, yoga studio, any ABS occupation title), it returns the ANZSIC class, which covers a law or a regulator requires of that class and which only a landlord, council, venue, head contractor or client requires, each with the source it was read from and the day, what the qualification check asks, which required covers the business has not said it holds (when holds is given), and the check URL that opens with those answers filled in and sends a brief to a licensed broker. OpenStream is not an insurer and not a broker and gives no advice.","tags":["Australia"],"parameters":[{"name":"business","in":"query","required":true,"description":"What the business is, in the person's word: 'electrician', 'cafe', 'physio', 'yoga studio'","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"nsw, vic, qld, sa, wa, tas, nt or act","schema":{"type":"string"}},{"name":"employs","in":"query","required":false,"description":"Whether it employs: employees, contractors, both, owner_only","schema":{"type":"string","enum":["employees","contractors","both","owner_only"]}},{"name":"holds","in":"query","required":false,"description":"Covers it already holds: any of public_liability, professional_indemnity, workers_comp, business_pack, product_liability, cyber, tools, commercial_motor, management_liability, none (comma-separated)","schema":{"type":"string","description":"comma-separated values"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/deals_now":{"get":{"operationId":"deals_now","summary":"Intro deals now (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. AUSTRALIA (AUD inc. GST). Every NBN and SIM-only mobile plan whose own page shows an introductory price now: the intro price and its months, the ongoing price after it, the first-year cost (intro months at the intro price, the rest at the ongoing price), the provider's stated end date where there is one, the day the price was read, the plan page and a sign-up hand-off; plus every deal that started, changed or ended in the last changes_days, filed the hour it was seen. Quote the intro price with its months and the ongoing price together, never the intro alone. Read date: per row read_at.","tags":["Australia"],"parameters":[{"name":"market","in":"query","required":false,"description":"","schema":{"type":"string","enum":["nbn","mobile"]}},{"name":"tier","in":"query","required":false,"description":"NBN speed band: 25, 50, 100, 250, 500, 750, 1000","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Default 15, max 50","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"changes_days","in":"query","required":false,"description":"Window for the filed changes; default 7","schema":{"type":"integer","minimum":1,"maximum":30}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/price_reset_gap":{"get":{"operationId":"price_reset_gap","summary":"Default offer vs cheapest plan (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. AUSTRALIA electricity (AUD inc. GST). Each network's regulated default offer for the year, the Default Market Offer (AER: NSW, south-east Queensland, SA) or the Victorian Default Offer (ESC), as an annual bill at the regulator's own benchmark usage, transcribed from the regulator's determination with its publication and read dates; beside it today's cheapest published plan on that network at the same usage from the regulator's listing, and the gap (the regulator's bill less twelve months of the estimate, the only arithmetic). Residential and small-business figures. Read dates: the source's fetched day and the snapshot_day per network.","tags":["Australia"],"parameters":[{"name":"state","in":"query","required":false,"description":"","schema":{"type":"string","enum":["NSW","QLD","SA","VIC"]}},{"name":"network","in":"query","required":false,"description":"Network name or slug, e.g. 'Ausgrid', 'citipower'","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/premium_rise":{"get":{"operationId":"premium_rise","summary":"Health premium rise round (Australia, AUD)","description":"Market: Australia; currency AUD; NBN and mobile plans re-read hourly from each provider's own page; electricity and gas from the regulators' listings nightly; private health insurance from PrivateHealth.gov.au's monthly release; business insurance obligations from regulators and government sources, with no premium of any kind. AUSTRALIA private health insurance (AUD). The federal premium round: the industry average change the Minister approved, when it was announced and took effect, each registered insurer's own average as the Department of Health, Disability and Ageing publishes it (largest first), the coming round or the department's own timing for it, the history of averages, and the cheapest open hospital policy for a single per state and tier from the regulator's release (premium before rebate) with the fund's average change beside it and a hand-off. Every figure cites its source and read day; nothing projects an average onto a policy.","tags":["Australia"],"parameters":[{"name":"state","in":"query","required":false,"description":"Limit the cheapest-policy table to one state","schema":{"type":"string","enum":["NSW","VIC","QLD","SA","WA","TAS","NT"]}},{"name":"tier","in":"query","required":false,"description":"Limit it to one tier: Basic, Bronze, Silver, Gold","schema":{"type":"string","enum":["Basic","Bronze","Silver","Gold"]}},{"name":"insurer","in":"query","required":false,"description":"Limit the insurer list to names containing this","schema":{"type":"string"}}],"responses":{"200":{"description":"{tool, market, arguments, is_error, text (the tool's markdown answer), result (the tool's structured result: rows with read dates, page URLs and hand-off URLs)}","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-openstream":{"invariants":["Margin only where a public wholesale reference exists; never estimated.","Every served number traces to a cited source with timestamps.","Reputation is served component-by-component, never as a composite.","internal-tier data (comparison rankings, editorial ratings) never serves.","A market answers in its own currency from its own data; markets never mix."],"dataset_status_note":"Responses carry dataset_status. `live` = figures collected from the cited public sources with capture timestamps; errors are possible, so check the cited sources.","markets":[{"id":"au","name":"Australia","currency":"AUD","hub":"https://openstream.com.au/","tools":["find_plans","find_mobile_plans","roaming_plans","smartwatch_plans","cheapest_plan","compare_plans","get_plan","check_address","cheapest_electricity","electricity_network","recommend_electricity","electricity_signup_link","recommend_plans","signup_link","plan_history","plan_changes","lookup_provider","search","fetch","health_cover_options","business_insurance_check","deals_now","price_reset_gap","premium_rise"]},{"id":"uk","name":"United Kingdom","currency":"GBP","hub":"https://openstream.com.au/uk","tools":["uk_broadband_plans"]},{"id":"nz","name":"New Zealand","currency":"NZD","hub":"https://openstream.com.au/nz","tools":["nz_broadband_plans"]},{"id":"us","name":"United States","currency":"USD","hub":"https://openstream.com.au/us","tools":["us_electricity_plans"]}],"mcp":{"endpoint":"https://openstream.com.au/api/mcp","discovery":"https://openstream.com.au/.well-known/mcp.json","tools":["find_plans","find_mobile_plans","roaming_plans","smartwatch_plans","cheapest_plan","compare_plans","get_plan","check_address","cheapest_electricity","electricity_network","recommend_electricity","electricity_signup_link","recommend_plans","signup_link","plan_history","plan_changes","lookup_provider","search","fetch","uk_broadband_plans","nz_broadband_plans","us_electricity_plans","health_cover_options","business_insurance_check","deals_now","price_reset_gap","premium_rise"]}}}