{"openapi":"3.1.0","info":{"title":"MachineEconomy.ai Public API","version":"1.0","description":"Read-only index data for the Machine Economy Index (MEI), Legal Rail Readiness Score (LRRS), and underlying metrics.\n\nSuccessful JSON responses use a `{ data, meta }` envelope with snake_case field names.\n\nAll /api/* responses include Access-Control-Allow-Origin: * and allow GET, POST, OPTIONS.\n\nMEI-input metric keys (is_mei_input=true when key matches): x402_volume_onchain_usdc_30d, x402_tx_count_30d, x402_active_agent_roles_30d, erc8004_registry_activity_30d, nvidia_dc_revenue, akash_created_leases_30d, akash_compute_spend_30d, filecoin_raw_power, filecoin_utilization, oecd_m2m_subscriptions, census_btos_ai_use, eurostat_ai_use, mcp_downloads_30d, pypi_agent_framework_30d.","license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"}},"servers":[{"url":"https://machineeconomy.ai","description":"Production"}],"paths":{"/api/v1/mei":{"get":{"operationId":"getMei","summary":"Latest MEI score","description":"Headline geometric composite, arithmetic composite, balance gap, component scores, and robustness band (score_low/score_high). Next.js ISR revalidate: 3600s.","tags":["MEI"],"responses":{"200":{"description":"Latest MEI score","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeiResponse"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}},"503":{"description":"No MEI score in database yet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"No MEI score available"}}}}}}},"/api/v1/widget":{"get":{"operationId":"getWidget","summary":"Embeddable MEI widget payload","description":"Reduced MEI payload for embeds (geometric score + components only). Next.js ISR revalidate: 3600s.","tags":["MEI"],"responses":{"200":{"description":"Widget MEI payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetResponse"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}},"503":{"description":"No MEI score in database yet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"No MEI score available"}}}}}}},"/api/v1/lrrs":{"get":{"operationId":"getLrrs","summary":"Latest LRRS score and jurisdiction coverage","description":"GDP-weighted Legal Rail Readiness Score with per-category coverage, jurisdiction statuses, and instrument citations. Next.js ISR revalidate: 3600s.","tags":["LRRS"],"responses":{"200":{"description":"Latest LRRS payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LrrsResponse"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}}}}},"/api/v1/lrrs/coverage-log":{"get":{"operationId":"getLrrsCoverageLog","summary":"LRRS candidate-survey coverage log","description":"Every cell of the LRRS survey grid (survey list × five categories) with the date of its latest complete candidate search whose results are live, and every recorded search (Ruling #12). Next.js ISR revalidate: 3600s.","tags":["LRRS"],"responses":{"200":{"description":"The coverage log as published today","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LrrsCoverageLogResponse"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}}}}},"/api/v1/metrics":{"get":{"operationId":"getMetrics","summary":"All tracked metrics","description":"Optional rail filter; unknown or omitted rail returns all metrics. Next.js ISR revalidate: 900s.","tags":["Metrics"],"parameters":[{"$ref":"#/components/parameters/RailQuery"}],"responses":{"200":{"description":"Metric series snapshot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricsResponse"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}}}}},"/api/v1/diagnostics":{"get":{"operationId":"getDiagnostics","summary":"Daily payment-rail diagnostics and triggers","description":"Report-only figures from x402scan's 30-day views, published daily, and the states of triggers X1–X5. Each trigger opens a review and changes no value. X1, X3 and X4 also report their latest run that reached 14 days (last_fired_on, last_run_started_on, last_run_ended_on), so a fired trigger stays visible after its run ends. Before the first reading, latest is null and every trigger says no reading yet. Next.js ISR revalidate: 900s.","tags":["Metrics"],"responses":{"200":{"description":"The latest reading, the trigger states and 180 days of history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnosticsResponse"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}}}}},"/api/v1/newsletter":{"post":{"operationId":"subscribeNewsletter","summary":"Join the Briefing waitlist","description":"Adds an email address to the Machine Economy Briefing waitlist (proxies to Beehiiv); nothing is sent until the Briefing launches. Not part of the { data, meta } index API envelope.","tags":["Newsletter"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterSubscribeBody"}}}},"responses":{"200":{"description":"Added to the waitlist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterSuccess"}}}},"400":{"description":"Invalid JSON or email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Valid email address required"}}}},"429":{"description":"Rate limit exceeded (100 requests/minute per IP on /api/v1/* when Upstash Redis is configured).","headers":{"Retry-After":{"description":"Seconds until the client may retry","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Rate limit exceeded. Please retry later."}}}},"500":{"description":"Beehiiv or adapter failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"Subscription failed"}}}}}}}},"components":{"schemas":{"ApiError":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false,"title":"ApiError"},"MeiResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"score_geometric":{"type":"number"},"score_arithmetic":{"type":"number"},"balance_gap":{"type":"number"},"components":{"type":"object","properties":{"payment":{"type":"number"},"physical":{"type":"number"},"legal":{"type":"number"},"macro":{"type":"number"}},"required":["payment","physical","legal","macro"],"additionalProperties":false},"score_low":{"description":"Robustness band lower bound (5th percentile of §6.7 Monte Carlo sensitivity; integer)","type":["number","null"]},"score_high":{"description":"Robustness band upper bound (95th percentile of §6.7 Monte Carlo sensitivity; integer)","type":["number","null"]},"methodology_version":{"type":"string"},"calculated_at":{"type":"string","description":"ISO 8601 date-time"}},"required":["score_geometric","score_arithmetic","balance_gap","components","score_low","score_high","methodology_version","calculated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"source":{"type":"string","const":"MachineEconomy.ai"},"docs":{"type":"string","const":"https://machineeconomy.ai/methodology"},"methodology_version":{"type":"string","enum":["1.0","1.1","1.2","1.3"]}},"required":["source","docs","methodology_version"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false,"title":"MeiResponse"},"WidgetResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"score_geometric":{"type":"number"},"components":{"type":"object","properties":{"payment":{"type":"number"},"physical":{"type":"number"},"legal":{"type":"number"},"macro":{"type":"number"}},"required":["payment","physical","legal","macro"],"additionalProperties":false},"methodology_version":{"type":"string"},"calculated_at":{"type":"string","description":"ISO 8601 date-time"}},"required":["score_geometric","components","methodology_version","calculated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"source":{"type":"string","const":"MachineEconomy.ai"},"docs":{"type":"string","const":"https://machineeconomy.ai/methodology"},"methodology_version":{"type":"string","enum":["1.0","1.1","1.2","1.3"]}},"required":["source","docs","methodology_version"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false,"title":"WidgetResponse"},"LrrsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"score":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"underlying":{"type":"number"},"coverage_by_category":{"type":"object","properties":{"legal_identity":{"type":"number"},"stablecoin":{"type":"number"},"sandbox":{"type":"number"},"free_zone":{"type":"number"},"multilateral":{"type":"number"}},"required":["legal_identity","stablecoin","sandbox","free_zone","multilateral"],"additionalProperties":false},"category_weights":{"type":"object","properties":{"legal_identity":{"type":"number"},"stablecoin":{"type":"number"},"sandbox":{"type":"number"},"free_zone":{"type":"number"},"multilateral":{"type":"number"}},"required":["legal_identity","stablecoin","sandbox","free_zone","multilateral"],"additionalProperties":false},"jurisdictions":{"type":"array","items":{"type":"object","properties":{"iso3":{"type":"string"},"statuses":{"type":"object","properties":{"legal_identity":{"type":"string","enum":["none","enacted","operational"]},"stablecoin":{"type":"string","enum":["none","enacted","operational"]},"sandbox":{"type":"string","enum":["none","enacted","operational"]},"free_zone":{"type":"string","enum":["none","enacted","operational"]},"multilateral":{"type":"string","enum":["none","enacted","operational"]}},"required":["legal_identity","stablecoin","sandbox","free_zone","multilateral"],"additionalProperties":false},"instruments":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string","enum":["legal_identity","stablecoin","sandbox","free_zone","multilateral"]},"status":{"type":"string","enum":["none","enacted","operational"]},"name":{"type":"string"},"citation_url":{"type":"string"},"citation_title":{"type":"string"}},"required":["category","status","name","citation_url","citation_title"],"additionalProperties":false}}},"required":["iso3","statuses","instruments"],"additionalProperties":false}},"surveyed_gdp_ceiling":{"type":"number"}},"required":["score","underlying","coverage_by_category","category_weights","jurisdictions","surveyed_gdp_ceiling"],"additionalProperties":false},"meta":{"type":"object","properties":{"source":{"type":"string","const":"MachineEconomy.ai"},"docs":{"type":"string","const":"https://machineeconomy.ai/methodology"},"methodology_version":{"type":"string","const":"1.0"},"gdp_vintage":{"type":"string"}},"required":["source","docs","methodology_version","gdp_vintage"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false,"title":"LrrsResponse"},"LrrsCoverageLogResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"as_of":{"type":"string"},"staleness_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scope_classes":{"type":"object","propertyNames":{"type":"string","enum":["legal_identity","stablecoin","sandbox","free_zone","multilateral"]},"additionalProperties":{"type":"array","items":{"type":"string"}},"required":["legal_identity","stablecoin","sandbox","free_zone","multilateral"]},"grid":{"type":"object","properties":{"jurisdictions":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string","enum":["legal_identity","stablecoin","sandbox","free_zone","multilateral"]}},"cell_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["jurisdictions","categories","cell_count"],"additionalProperties":false},"cells_searched_at_full_scope":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cells_not_yet_searched":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cells":{"type":"array","items":{"type":"object","properties":{"jurisdiction":{"type":"string"},"category":{"type":"string","enum":["legal_identity","stablecoin","sandbox","free_zone","multilateral"]},"last_complete_search":{"type":["string","null"]},"results_live_from":{"type":["string","null"]}},"required":["jurisdiction","category","last_complete_search","results_live_from"],"additionalProperties":false}},"searches":{"type":"array","items":{"type":"object","properties":{"jurisdiction":{"type":"string"},"category":{"type":"string","enum":["legal_identity","stablecoin","sandbox","free_zone","multilateral"]},"searched_as_of":{"type":"string"},"scope_classes":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"source_pack":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"candidate":{"type":"string"},"outcome":{"type":"string"}},"required":["candidate","outcome"],"additionalProperties":false}},"update_date":{"type":["string","null"]}},"required":["jurisdiction","category","searched_as_of","scope_classes","sources","source_pack","results","update_date"],"additionalProperties":false}}},"required":["as_of","staleness_days","scope_classes","grid","cells_searched_at_full_scope","cells_not_yet_searched","cells","searches"],"additionalProperties":false},"meta":{"type":"object","properties":{"source":{"type":"string","const":"MachineEconomy.ai"},"docs":{"type":"string","const":"https://machineeconomy.ai/methodology#section-lrrs"},"record":{"type":"string","const":"db/seeds/lrrs-coverage-log.ts"}},"required":["source","docs","record"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false,"title":"LrrsCoverageLogResponse"},"MetricsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"value":{"type":["number","null"]},"unit":{"type":"string"},"rail":{"type":"string","enum":["payment","physical","macro"]},"category":{"type":"string"},"source":{"type":"string"},"source_url":{"type":["string","null"]},"is_stale":{"type":"boolean"},"is_provisional":{"type":"boolean"},"is_mei_input":{"type":"boolean"},"fetched_at":{"anyOf":[{"type":"string","description":"ISO 8601 date-time"},{"type":"null"}]},"hold":{"anyOf":[{"type":"object","properties":{"held_value":{"type":"number"},"since":{"type":"string","description":"UTC date (YYYY-MM-DD)"},"review_by":{"type":"string","description":"UTC date (YYYY-MM-DD)"},"reason":{"type":"string"}},"required":["held_value","since","review_by","reason"],"additionalProperties":false},{"type":"null"}],"description":"Set while the value is held at its last clean value under a committed decision (the value-jump safeguard refused the fetched value), from since to review_by (UTC days, inclusive); null otherwise — outside those dates a value still carried forward shows only is_stale: true"},"note":{"anyOf":[{"type":"object","properties":{"text":{"type":"string"},"from":{"type":"string","description":"UTC date (YYYY-MM-DD)"},"to":{"type":"string","description":"UTC date (YYYY-MM-DD)"}},"required":["text","from","to"],"additionalProperties":false},{"type":"null"}],"description":"Set while a committed public note applies to the value (from ≤ today ≤ to, UTC): what the published value contains, while its cause is in the window; null otherwise"}},"required":["key","label","value","unit","rail","category","source","source_url","is_stale","is_provisional","is_mei_input","fetched_at","hold","note"],"additionalProperties":false}},"meta":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"string","const":"MachineEconomy.ai"},"docs":{"type":"string","const":"https://machineeconomy.ai/methodology"}},"required":["count","source","docs"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false,"title":"MetricsResponse"},"DiagnosticsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"x402":{"type":"object","properties":{"latest":{"anyOf":[{"type":"object","properties":{"day":{"type":"string","description":"UTC date (YYYY-MM-DD) of the read"},"read_at":{"type":"string","description":"ISO 8601 date-time"},"status":{"type":"string","enum":["complete","failed"],"description":"failed: the read failed, and every figure is null"},"overall_as_of":{"anyOf":[{"type":"string","description":"ISO 8601 date-time"},{"type":"null"}],"description":"latest_block_timestamp of x402scan's overall 30-day view"},"sender_as_of":{"anyOf":[{"type":"string","description":"ISO 8601 date-time"},{"type":"null"}],"description":"latest_block_timestamp of x402scan's sender-level 30-day view"},"overall_fresh":{"description":"The overall view was at most 36 hours old at the read","type":["boolean","null"]},"sender_fresh":{"description":"The sender view was at most 36 hours old at the read","type":["boolean","null"]},"raw_tx_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"capped_tx_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Each paying address credited at most 10,000 settlements"},"raw_over_capped":{"type":["number","null"]},"payers_above_cap":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"top1_tx_share":{"type":["number","null"]},"top5_tx_share":{"type":["number","null"]},"top1_volume_share":{"type":["number","null"]},"top5_volume_share":{"type":["number","null"]},"raw_usd_per_tx":{"type":["number","null"]},"raw_usd_per_tx_in_band":{"description":"Inside the triplet band [$0.25, $5.00], both ends inside","type":["boolean","null"]},"scored_usd_per_tx":{"description":"The published volume ÷ the published transaction count","type":["number","null"]},"scored_usd_per_tx_in_band":{"type":["boolean","null"]},"distinct_payers":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"distinct_recipients":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"roles_per_group_sum":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"overall_tx_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"overall_volume_usd":{"type":["number","null"]},"sender_volume_usd":{"type":["number","null"]},"payers_above_cap_list":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"settlements":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amount":{"type":"number","description":"USD"}},"required":["address","settlements","amount"],"additionalProperties":false}},{"type":"null"}]},"top_volume_payers":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"amount":{"type":"number","description":"USD"}},"required":["address","amount"],"additionalProperties":false}},{"type":"null"}]},"fan_out_payers":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"recipients":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["address","recipients"],"additionalProperties":false}},{"type":"null"}],"description":"Payers with more than 1,000 distinct recipients"},"top_payees":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"payers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["address","payers"],"additionalProperties":false}},{"type":"null"}],"description":"The five payees with the most distinct payers"},"lists_complete":{"description":"False when a page limit cut a list short","type":["boolean","null"]}},"required":["day","read_at","status","overall_as_of","sender_as_of","overall_fresh","sender_fresh","raw_tx_count","capped_tx_count","raw_over_capped","payers_above_cap","top1_tx_share","top5_tx_share","top1_volume_share","top5_volume_share","raw_usd_per_tx","raw_usd_per_tx_in_band","scored_usd_per_tx","scored_usd_per_tx_in_band","distinct_payers","distinct_recipients","roles_per_group_sum","overall_tx_count","overall_volume_usd","sender_volume_usd","payers_above_cap_list","top_volume_payers","fan_out_payers","top_payees","lists_complete"],"additionalProperties":false},{"type":"null"}],"description":"The latest read; null before the first"},"triggers":{"type":"object","properties":{"x1":{"type":"object","properties":{"state":{"type":"string","enum":["no reading yet","not fired","fired"]},"run_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Consecutive UTC days the condition has held"},"required_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"run_started_on":{"type":["string","null"]},"fired_on":{"type":["string","null"]},"last_fired_on":{"description":"The latest run that reached 14 days: the day it reached them. Null if no run has","type":["string","null"]},"last_run_started_on":{"description":"That run's first day","type":["string","null"]},"last_run_ended_on":{"description":"That run's last day; null while the run lasts","type":["string","null"]},"summary":{"type":"string"},"top1_volume_share":{"type":["number","null"]},"threshold":{"type":"number"}},"required":["state","run_days","required_days","run_started_on","fired_on","last_fired_on","last_run_started_on","last_run_ended_on","summary","top1_volume_share","threshold"],"additionalProperties":false,"description":"Volume concentration: one payer at half of 30-day volume or more"},"x2":{"type":"object","properties":{"state":{"type":"string","enum":["no reading yet","not yet evaluable","not monitored","monitored"]},"span_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"required_span_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"median":{"description":"Rolling 180-day median of raw ÷ capped count (before 180 days, the median so far)","type":["number","null"]},"entered_on":{"type":["string","null"]},"annual_re_review":{"type":["string","null"]},"exit_run_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"required_exit_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"summary":{"type":"string"}},"required":["state","span_days","required_span_days","median","entered_on","annual_re_review","exit_run_days","required_exit_days","summary"],"additionalProperties":false,"description":"Count concentration"},"x3":{"type":"object","properties":{"state":{"type":"string","enum":["no reading yet","not fired","fired"]},"run_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Consecutive UTC days the condition has held"},"required_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"run_started_on":{"type":["string","null"]},"fired_on":{"type":["string","null"]},"last_fired_on":{"description":"The latest run that reached 14 days: the day it reached them. Null if no run has","type":["string","null"]},"last_run_started_on":{"description":"That run's first day","type":["string","null"]},"last_run_ended_on":{"description":"That run's last day; null while the run lasts","type":["string","null"]},"summary":{"type":"string"},"scored_usd_per_tx":{"type":["number","null"]},"band_min":{"type":"number"},"band_max":{"type":"number"}},"required":["state","run_days","required_days","run_started_on","fired_on","last_fired_on","last_run_started_on","last_run_ended_on","summary","scored_usd_per_tx","band_min","band_max"],"additionalProperties":false,"description":"Pair coherence: scored $/tx outside the triplet band"},"x4":{"type":"object","properties":{"state":{"type":"string","enum":["no reading yet","not fired","fired"]},"run_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Consecutive UTC days the condition has held"},"required_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"run_started_on":{"type":["string","null"]},"fired_on":{"type":["string","null"]},"last_fired_on":{"description":"The latest run that reached 14 days: the day it reached them. Null if no run has","type":["string","null"]},"last_run_started_on":{"description":"That run's first day","type":["string","null"]},"last_run_ended_on":{"description":"That run's last day; null while the run lasts","type":["string","null"]},"summary":{"type":"string"},"overall_as_of":{"anyOf":[{"type":"string","description":"ISO 8601 date-time"},{"type":"null"}]},"overall_fresh":{"type":["boolean","null"]}},"required":["state","run_days","required_days","run_started_on","fired_on","last_fired_on","last_run_started_on","last_run_ended_on","summary","overall_as_of","overall_fresh"],"additionalProperties":false,"description":"Source: the 30-day view stale or unread"},"x5":{"type":"object","properties":{"state":{"type":"string","enum":["no reading yet","armed","fired"]},"latest_sweep":{"type":["string","null"]},"latest_s":{"type":["number","null"]},"run_sweeps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"required_sweeps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fired_at_sweep":{"type":["string","null"]},"summary":{"type":"string"}},"required":["state","latest_sweep","latest_s","run_sweeps","required_sweeps","fired_at_sweep","summary"],"additionalProperties":false,"description":"Single-use participation, read at each monthly sweep"}},"required":["x1","x2","x3","x4","x5"],"additionalProperties":false},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","description":"UTC date (YYYY-MM-DD) of the read"},"read_at":{"type":"string","description":"ISO 8601 date-time"},"status":{"type":"string","enum":["complete","failed"],"description":"failed: the read failed, and every figure is null"},"overall_as_of":{"anyOf":[{"type":"string","description":"ISO 8601 date-time"},{"type":"null"}],"description":"latest_block_timestamp of x402scan's overall 30-day view"},"sender_as_of":{"anyOf":[{"type":"string","description":"ISO 8601 date-time"},{"type":"null"}],"description":"latest_block_timestamp of x402scan's sender-level 30-day view"},"overall_fresh":{"description":"The overall view was at most 36 hours old at the read","type":["boolean","null"]},"sender_fresh":{"description":"The sender view was at most 36 hours old at the read","type":["boolean","null"]},"raw_tx_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"capped_tx_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Each paying address credited at most 10,000 settlements"},"raw_over_capped":{"type":["number","null"]},"payers_above_cap":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"top1_tx_share":{"type":["number","null"]},"top5_tx_share":{"type":["number","null"]},"top1_volume_share":{"type":["number","null"]},"top5_volume_share":{"type":["number","null"]},"raw_usd_per_tx":{"type":["number","null"]},"raw_usd_per_tx_in_band":{"description":"Inside the triplet band [$0.25, $5.00], both ends inside","type":["boolean","null"]},"scored_usd_per_tx":{"description":"The published volume ÷ the published transaction count","type":["number","null"]},"scored_usd_per_tx_in_band":{"type":["boolean","null"]},"distinct_payers":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"distinct_recipients":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"roles_per_group_sum":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"overall_tx_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"overall_volume_usd":{"type":["number","null"]},"sender_volume_usd":{"type":["number","null"]}},"required":["day","read_at","status","overall_as_of","sender_as_of","overall_fresh","sender_fresh","raw_tx_count","capped_tx_count","raw_over_capped","payers_above_cap","top1_tx_share","top5_tx_share","top1_volume_share","top5_volume_share","raw_usd_per_tx","raw_usd_per_tx_in_band","scored_usd_per_tx","scored_usd_per_tx_in_band","distinct_payers","distinct_recipients","roles_per_group_sum","overall_tx_count","overall_volume_usd","sender_volume_usd"],"additionalProperties":false},"description":"One entry per UTC day, the day's last read, for the last 180 days"}},"required":["latest","triggers","history"],"additionalProperties":false}},"required":["x402"],"additionalProperties":false},"meta":{"type":"object","properties":{"source":{"type":"string","const":"MachineEconomy.ai"},"docs":{"type":"string","const":"https://machineeconomy.ai/methodology#section-scope"}},"required":["source","docs"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false,"title":"DiagnosticsResponse"},"NewsletterSubscribeBody":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"],"additionalProperties":false,"title":"NewsletterSubscribeBody"},"NewsletterSuccess":{"type":"object","properties":{"success":{"type":"boolean","const":true}},"required":["success"],"additionalProperties":false,"title":"NewsletterSuccess"}},"responses":{},"parameters":{"RailQuery":{"name":"rail","in":"query","required":false,"description":"Filter metrics by rail. Values outside payment | physical | macro are ignored (all metrics returned).","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["payment","physical","macro"]}}}}}