{"openapi":"3.1.0","info":{"title":"WattSaid API","description":"WattSaid™ by Starfind AI: its own numbers on AI and the power behind it (the Live board's indicators, US grid stress against normal, robot model licences and their changes), built for programs and AI agents. The numbers are WattSaid Pro's ($49 a month + tax: 50,000 requests a day, full history, CSV); /catalog, /methods, /me and these docs are open without it. Read https://api.starfindai.com/wattsaid/v1/docs.md first.","version":"1"},"servers":[{"url":"https://api.starfindai.com/wattsaid/v1"}],"paths":{"/docs.md":{"get":{"summary":"This API described for an agent, in Markdown. Not counted.","operationId":"read_docs","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/catalog":{"get":{"summary":"Every series: its id, unit, how often it changes and its earliest point. Start here.","operationId":"list_series","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"HTTPBearer":[]}]}},"/methods":{"get":{"summary":"Every number WattSaid shows: what it is, what it covers, how often it changes, how far back it goes and how it is worked out. Open to anyone.","operationId":"list_methods","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Methods"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"HTTPBearer":[]}]}},"/snapshot":{"get":{"summary":"Every series' current value in one call, with its unit, time, change and whether it is delayed.","operationId":"get_snapshot","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Snapshot"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"HTTPBearer":[]}]}},"/series/{series_id}":{"get":{"summary":"One series: its current value and its points, oldest first. Pro gets every point kept, and CSV.","operationId":"get_series","security":[{"HTTPBearer":[]}],"parameters":[{"name":"series_id","in":"path","required":true,"schema":{"type":"string","title":"Series Id"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Only points after this time (the format of Point.at).","title":"Since"},"description":"Only points after this time (the format of Point.at)."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Only points up to and including this time.","title":"Until"},"description":"Only points up to and including this time."},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","description":"csv: the points as at,value rows.","default":"json","title":"Format"},"description":"csv: the points as at,value rows."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Series"}}}},"404":{"description":"No series has this id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/physical-ai/models":{"get":{"summary":"Reviewed robot-control models and the commercial use their licences declare for code, weights and training data.","operationId":"list_robot_models","security":[{"HTTPBearer":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","description":"csv: one row per model, its three verdicts and declared terms.","default":"json","title":"Format"},"description":"csv: one row per model, its three verdicts and declared terms."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RobotModels"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/physical-ai/models/{model_id}":{"get":{"summary":"One reviewed robot model and its declared terms.","operationId":"get_robot_model","security":[{"HTTPBearer":[]}],"parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RobotModelAnswer"}}}},"404":{"description":"No reviewed model has this id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/me":{"get":{"summary":"Who this request counts as, its plan and subscription, and how much of today's limits is left. Not counted.","operationId":"get_me","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/checkout":{"post":{"summary":"A Stripe Checkout link for WattSaid Pro ($49 a month + tax). Give it to the person who pays; never pay yourself.","operationId":"start_checkout","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Link"}}}},"409":{"description":"The account already has Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"HTTPBearer":[]}]}},"/billing/portal":{"post":{"summary":"A Stripe link where a person cancels, changes the card or reads invoices.","operationId":"open_billing_portal","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Link"}}}},"404":{"description":"The account has no subscription.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"The key or session was not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"This needs WattSaid Pro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"The daily limit is used up; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"The numbers or the key check are unavailable for a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"security":[{"HTTPBearer":[]}]}},"/grid/summary":{"get":{"tags":["US Grid Stress"],"summary":"Every grid now: load against normal, stress hours in 30 days against a year before, 12-month growth, its states' data center pipeline.","operationId":"grid_summary","security":[{"HTTPBearer":[]}],"parameters":[{"name":"threshold","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":200,"minimum":0.5},{"type":"null"}],"description":"A fixed percent over normal from which an hour is a stress hour. Leave it out to use top.","title":"Threshold"},"description":"A fixed percent over normal from which an hour is a stress hour. Leave it out to use top."},{"name":"top","in":"query","required":false,"schema":{"type":"number","maximum":50,"minimum":0.1,"description":"Without threshold: a stress hour is in the grid's own top this-percent of hours since January 2022.","default":5.0,"title":"Top"},"description":"Without threshold: a stress hour is in the grid's own top this-percent of hours since January 2022."},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/grid/datacenters":{"get":{"tags":["US Grid Stress"],"summary":"AI load on the grid: each state's data center pipeline and business electricity growth beside its grid's load growth and stress.","operationId":"grid_datacenters","security":[{"HTTPBearer":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/btm/summary":{"get":{"tags":["BTM"],"summary":"Behind-the-meter power for data centers: onsite power by state joined with the data center pipeline and reviewed projects, and national figures.","operationId":"btm_summary","security":[{"HTTPBearer":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/china/compare":{"get":{"tags":["China"],"summary":"China against the US: the paired measures, or one measure's ratio (or gap), growth and index on mutual periods.","operationId":"china_compare","security":[{"HTTPBearer":[]}],"parameters":[{"name":"measure","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A measure from the list this path gives without it.","title":"Measure"},"description":"A measure from the list this path gives without it."},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/physical-ai/changes":{"get":{"tags":["Physical AI Tracker"],"summary":"Every licence, gating or file change found in robot models by comparing daily copies, newest first.","operationId":"list_licence_changes","security":[{"HTTPBearer":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Only changes seen after this day, YYYY-MM-DD.","title":"Since"},"description":"Only changes seen after this day, YYYY-MM-DD."},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/physical-ai/adoption":{"get":{"tags":["Physical AI Tracker"],"summary":"Open robotics and open AI model use against usual (100 = the median of the four weeks before), daily.","operationId":"physical_ai_adoption","security":[{"HTTPBearer":[]}],"parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"First day, YYYY-MM-DD; a year ago by default.","title":"From"},"description":"First day, YYYY-MM-DD; a year ago by default."},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Last day, YYYY-MM-DD; today by default.","title":"To"},"description":"Last day, YYYY-MM-DD; today by default."},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/overview/sample":{"get":{"tags":["Overview"],"summary":"A sample of the Pro issue for any account on the site: the issue of 30 days before the latest, with onsite power for the five leading states.","operationId":"overview_sample","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/overview":{"get":{"tags":["Overview"],"summary":"The day's Pro issue in one call: the lead grid, every grid's day joined with its states' data center pipeline, AI load, China against the US, Physical AI.","operationId":"overview","security":[{"HTTPBearer":[]}],"parameters":[{"name":"day","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"The issue's day, YYYY-MM-DD, 2022-01-01 or later; the latest full day by default.","title":"Day"},"description":"The issue's day, YYYY-MM-DD, 2022-01-01 or later; the latest full day by default."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/watches":{"get":{"tags":["Alerts"],"summary":"What this account watches; WattSaid Pro emails about them once a day.","operationId":"list_watches","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response List Watches"}}}}},"security":[{"HTTPBearer":[]}]}},"/watches/webhook":{"put":{"tags":["Alerts"],"summary":"Also send this account's alerts to a Slack channel or an https endpoint of its own. WattSaid Pro.","operationId":"set_alert_webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hook"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Set Alert Webhook"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]},"delete":{"tags":["Alerts"],"summary":"Stop sending alerts to the Slack channel or webhook; the email stays.","operationId":"remove_alert_webhook","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Remove Alert Webhook"}}}}},"security":[{"HTTPBearer":[]}]}},"/watches/webhook/test":{"post":{"tags":["Alerts"],"summary":"Post one test message to the account's Slack channel or webhook.","operationId":"test_alert_webhook","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Test Alert Webhook"}}}}},"security":[{"HTTPBearer":[]}]}},"/watches/{kind}/{target}":{"put":{"tags":["Alerts"],"summary":"Watch a grid (stress hours each day) or a robot model (licence, access and file changes). WattSaid Pro.","operationId":"add_watch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}},{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Add Watch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Alerts"],"summary":"Stop watching a grid or a model.","operationId":"remove_watch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}},{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Remove Watch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Catalog":{"properties":{"updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated","description":"When the newest number was collected (UTC)."},"series":{"items":{"$ref":"#/components/schemas/Listed"},"type":"array","title":"Series"}},"type":"object","required":["updated","series"],"title":"Catalog"},"Change":{"properties":{"value":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Value","description":"The change, in `unit`."},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"'%' for a percentage change; otherwise the unit of a plain difference ('' for a count)."},"against":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Against","description":"What the value is compared with, e.g. 'the same hour yesterday'."}},"type":"object","required":["value","unit","against"],"title":"Change"},"Cite":{"properties":{"text":{"type":"string","title":"Text","description":"Name this when you quote a number from the answer."},"url":{"type":"string","title":"Url","description":"Link this when you quote a number from the answer."},"licence":{"type":"string","title":"Licence","description":"What the numbers may be used for: the key's account's own use; teams, products, redistribution and AI training need a WattSaid data licence."}},"type":"object","required":["text","url","licence"],"title":"Cite"},"Current":{"properties":{"id":{"type":"string","title":"Id","description":"The series id. It is never renamed."},"label":{"type":"string","title":"Label"},"group":{"type":"string","title":"Group"},"value":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"The unit of value."},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"The time the value is for, as the source gives it (see Point.at)."},"collected":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collected","description":"When WattSaid last collected the series (UTC)."},"delayed":{"type":"boolean","title":"Delayed","description":"True when the collecting or the source is behind its usual pace: check as_of before relying on the value."},"cadence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cadence"},"change":{"anyOf":[{"$ref":"#/components/schemas/Change"},{"type":"null"}],"description":"How the value moved, when the source allows a comparison."},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"Anything a reader must know to use the value correctly."},"url":{"type":"string","title":"Url","description":"This series in the API, with its points."}},"type":"object","required":["id","label","group","value","unit","as_of","collected","delayed","cadence","change","note","url"],"title":"Current"},"DataLicence":{"properties":{"kind":{"type":"string","enum":["team","display","redistribution","ai"],"title":"Kind","description":"team, display (and client delivery), redistribution or ai."},"company":{"type":"string","title":"Company"},"ends":{"type":"string","title":"Ends","description":"The last day it runs (YYYY-MM-DD)."}},"type":"object","required":["kind","company","ends"],"title":"DataLicence"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Hook":{"properties":{"url":{"type":"string","maxLength":500,"title":"Url","description":"An https address that takes a JSON POST, such as a Slack incoming webhook."}},"type":"object","required":["url"],"title":"Hook"},"Key":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["id","name"],"title":"Key"},"Limit":{"properties":{"counted_by":{"type":"string","enum":["address","key","account"],"title":"Counted By","description":"What the limit counts: requests without a key per address, per key, or all of an account's keys and sessions together."},"per_day":{"type":"integer","title":"Per Day"},"used":{"type":"integer","title":"Used"},"remaining":{"type":"integer","title":"Remaining"}},"type":"object","required":["counted_by","per_day","used","remaining"],"title":"Limit"},"Link":{"properties":{"url":{"type":"string","title":"Url","description":"A Stripe page for a person to open in a browser. Do not pay on someone's behalf."},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At","description":"When the link stops working."},"trial_days":{"type":"integer","title":"Trial Days","description":"Days free before the first charge: 7 for an account, address and card that never had the trial, else 0.","default":0}},"type":"object","required":["url"],"title":"Link"},"Listed":{"properties":{"id":{"type":"string","title":"Id","description":"The series id. It is never renamed."},"label":{"type":"string","title":"Label"},"group":{"type":"string","title":"Group","description":"The Live board group, e.g. Power, Onsite power, Buzz."},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"The unit of value, e.g. MW, $/MWh, %, stories in 24 hours."},"cadence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cadence","description":"How often the value changes: hourly, daily, weekly, monthly or yearly."},"first":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First","description":"The earliest point this plan returns (see Point.at)."},"history_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"History From","description":"The earliest point WattSaid keeps; Pro gets every point from here."},"definition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Definition","description":"What the number is."},"coverage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage","description":"Where and what it counts, and what it leaves out."},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method","description":"How WattSaid works it out, in short. Sources are not named."},"url":{"type":"string","title":"Url","description":"This series in the API."}},"type":"object","required":["id","label","group","unit","cadence","first","history_from","definition","coverage","method","url"],"title":"Listed"},"Me":{"properties":{"via":{"type":"string","enum":["anonymous","api_key","session","oauth"],"title":"Via","description":"How this request was identified; oauth: a connector the person signed in to."},"account":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account","description":"The WattSaid account the key belongs to."},"key":{"anyOf":[{"$ref":"#/components/schemas/Key"},{"type":"null"}]},"plan":{"type":"string","enum":["anonymous","free","pro"],"title":"Plan"},"limits":{"items":{"$ref":"#/components/schemas/Limit"},"type":"array","title":"Limits"},"resets_at":{"type":"string","title":"Resets At","description":"When every daily limit starts again (00:00 UTC)."},"subscription":{"anyOf":[{"$ref":"#/components/schemas/Subscription"},{"type":"null"}],"description":"The account's WattSaid Pro subscription, if it ever had one."},"upgrade":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upgrade","description":"How to get more: a free key, or WattSaid Pro. Empty on Pro."},"notice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notice","description":"Something the person should know, such as why a free trial was cancelled. Nothing was charged when it says so."},"licence":{"anyOf":[{"$ref":"#/components/schemas/DataLicence"},{"type":"null"}],"description":"The account's WattSaid data licence, if a company holds one for it. It gives Pro while it runs."},"keys_page":{"type":"string","title":"Keys Page","description":"Where a person creates and revokes keys, upgrades and manages the subscription."}},"type":"object","required":["via","account","key","plan","limits","resets_at","subscription","upgrade","keys_page"],"title":"Me"},"Method":{"properties":{"id":{"type":"string","title":"Id","description":"The number's id, as on the live board and in the API. It is never renamed."},"label":{"type":"string","title":"Label"},"group":{"type":"string","title":"Group","description":"The live board group. The three WattSaid follows most come first: Onsite power and Data centers (behind-the-meter power), Physical AI, China and the US."},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"cadence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cadence","description":"How often the value changes: hourly, daily, weekly, monthly, quarterly or yearly."},"definition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Definition","description":"What the number is."},"coverage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage","description":"Where and what it counts, and what it leaves out."},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method","description":"How WattSaid works it out, in short. Sources are not named."},"history_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"History From","description":"The earliest point WattSaid keeps (see Point.at)."},"in_api":{"type":"boolean","title":"In Api","description":"True when /series/{id} serves it on its own; the others reach the API inside a product, or are on the site only."},"download":{"type":"string","title":"Download","description":"What a WattSaid Pro download of it on the website holds: open (as shown), wattsaid (WattSaid's own aggregate), china (China against the US) or none."},"licensable":{"type":"string","enum":["yes","on_request","no"],"title":"Licensable","description":"Whether a WattSaid data licence (teams, products, redistribution, AI) can include it: yes; on_request, once its terms are checked; no."}},"type":"object","required":["id","label","group","unit","cadence","definition","coverage","method","history_from","in_api","download","licensable"],"title":"Method"},"Methods":{"properties":{"updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated","description":"When the newest number was collected (UTC)."},"numbers":{"items":{"$ref":"#/components/schemas/Method"},"type":"array","title":"Numbers"}},"type":"object","required":["updated","numbers"],"title":"Methods"},"Point":{"properties":{"at":{"type":"string","title":"At","description":"The time or period the value is for: ISO 8601 in UTC for an hour, YYYY-MM-DD for a day, YYYY-MM or YYYY for a month or a year."},"value":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Value"}},"type":"object","required":["at","value"],"title":"Point"},"Problem":{"properties":{"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"status":{"type":"integer","title":"Status"},"detail":{"type":"string","title":"Detail","description":"What went wrong."},"fix":{"type":"string","title":"Fix","description":"What to do next."},"docs":{"type":"string","title":"Docs"}},"type":"object","required":["type","title","status","detail","fix","docs"],"title":"Problem"},"RobotModel":{"properties":{"id":{"type":"string","title":"Id","description":"The model id, as in its page on starfindai.com."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"organization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"e.g. manipulation, locomotion, navigation, self-driving."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"The model's own page."},"page":{"type":"string","title":"Page","description":"The model's page on starfindai.com."},"review_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Status"},"last_reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Reviewed At"},"terms":{"additionalProperties":{"$ref":"#/components/schemas/Terms"},"type":"object","title":"Terms","description":"Commercial-use verdicts for code, weights and data (its training data)."}},"type":"object","required":["id","name","organization","category","source_url","page","review_status","last_reviewed_at","terms"],"title":"RobotModel"},"RobotModelAnswer":{"properties":{"id":{"type":"string","title":"Id","description":"The model id, as in its page on starfindai.com."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"organization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"e.g. manipulation, locomotion, navigation, self-driving."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"The model's own page."},"page":{"type":"string","title":"Page","description":"The model's page on starfindai.com."},"review_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Status"},"last_reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Reviewed At"},"terms":{"additionalProperties":{"$ref":"#/components/schemas/Terms"},"type":"object","title":"Terms","description":"Commercial-use verdicts for code, weights and data (its training data)."},"cite":{"$ref":"#/components/schemas/Cite"}},"type":"object","required":["id","name","organization","category","source_url","page","review_status","last_reviewed_at","terms","cite"],"title":"RobotModelAnswer"},"RobotModels":{"properties":{"updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated"},"models":{"items":{"$ref":"#/components/schemas/RobotModel"},"type":"array","title":"Models"},"cite":{"$ref":"#/components/schemas/Cite"}},"type":"object","required":["updated","models","cite"],"title":"RobotModels"},"Series":{"properties":{"id":{"type":"string","title":"Id","description":"The series id. It is never renamed."},"label":{"type":"string","title":"Label"},"group":{"type":"string","title":"Group"},"value":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"The unit of value."},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"The time the value is for, as the source gives it (see Point.at)."},"collected":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collected","description":"When WattSaid last collected the series (UTC)."},"delayed":{"type":"boolean","title":"Delayed","description":"True when the collecting or the source is behind its usual pace: check as_of before relying on the value."},"cadence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cadence"},"change":{"anyOf":[{"$ref":"#/components/schemas/Change"},{"type":"null"}],"description":"How the value moved, when the source allows a comparison."},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"Anything a reader must know to use the value correctly."},"url":{"type":"string","title":"Url","description":"This series in the API, with its points."},"points":{"items":{"$ref":"#/components/schemas/Point"},"type":"array","title":"Points","description":"Oldest first. Free: the newest 30 points (72 hours for an hourly series). Pro: every point kept."},"cite":{"$ref":"#/components/schemas/Cite"}},"type":"object","required":["id","label","group","value","unit","as_of","collected","delayed","cadence","change","note","url","points","cite"],"title":"Series"},"Snapshot":{"properties":{"updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated","description":"When the newest number was collected (UTC)."},"series":{"items":{"$ref":"#/components/schemas/Current"},"type":"array","title":"Series"},"cite":{"$ref":"#/components/schemas/Cite"}},"type":"object","required":["updated","series","cite"],"title":"Snapshot"},"Subscription":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Stripe's status of the WattSaid Pro subscription: active, trialing, past_due (the card is being retried), canceled, ..."},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"When the paid period ends. It renews then unless cancel_at_period_end is true."},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End"}},"type":"object","required":["status","period_end","cancel_at_period_end"],"title":"Subscription"},"Terms":{"properties":{"declared":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Declared","description":"The licence as declared, in a few words."},"commercial_use":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commercial Use","description":"permitted, not_permitted or unclear, as the licence file declares (or the licence field where there is no file). Not legal advice."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url","description":"Where the declaration was read."}},"type":"object","required":["declared","commercial_use","source_url"],"title":"Terms"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","description":"A WattSaid API key (ak_...). Leave the header out to call without one; create a key at https://starfindai.com/wattsaid/account.","scheme":"bearer"}}}}