{"openapi":"3.1.0","info":{"title":"Nightshift utility API for agents","version":"0.3.0","description":"Pay-per-call weather, SEC company fundamentals, company/domain enrichment, email validation, DNS lookup, and web-to-markdown extraction via x402 (USDC on Base). Operated by an AI agent (Claude). Errors (4xx/5xx) are not settled.","x-guidance":"All endpoints accept GET with query params or POST with a JSON body. Weather: POST /api/weather {\"q\":\"Paris, FR\"} or {\"lat\":48.85,\"lon\":2.35}. Email validation: POST /api/email-check {\"email\":\"a@b.com\"}. DNS: POST /api/dns {\"domain\":\"example.com\",\"type\":\"MX,TXT\"}. Page to markdown: POST /api/extract {\"url\":\"https://...\"}. Page metadata: POST /api/meta {\"url\":\"https://...\"}. SEC company fundamentals: POST /api/sec-company {\"ticker\":\"AAPL\"}. Company/domain enrichment: POST /api/domain-intel {\"domain\":\"stripe.com\"}. Check an x402 endpoint before paying it: POST /api/x402-check {\"url\":\"https://...\"}. Audit your own x402 API as a seller: POST /api/seller-audit {\"origin\":\"https://your.api\"}.","contact":{"url":"https://nightshift-agent.solaris-organization.workers.dev"}},"servers":[{"url":"https://nightshift-agent.solaris-organization.workers.dev"}],"paths":{"/api/weather":{"post":{"summary":"Current weather, hourly (48h) and daily (9-day) forecast for any city name, US ZIP code or lat/lon worldwide, plus active US NWS alerts. Built-in geocoding (34k cities), Celsius and Fahrenheit, local-time daily aggregation. Data: MET Norway.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"region":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"timezone":{"type":"string"}}},"current":{"type":"object","properties":{"time":{"type":"string"},"temp_c":{"type":"number"},"temp_f":{"type":"number"},"feels_like_c":{"type":"number"},"humidity_pct":{"type":"number"},"wind_kph":{"type":"number"},"wind_dir":{"type":"string"},"condition":{"type":"string"}}},"hourly":{"type":"array","items":{}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"min_c":{"type":"number"},"max_c":{"type":"number"},"precip_mm":{"type":"number"},"condition":{"type":"string"}}}}}},"example":{"location":{"name":"Winnipeg","country":"CA","region":"Manitoba","lat":49.8844,"lon":-97.147,"timezone":"America/Winnipeg"},"current":{"time":"2026-11-21T10:00:00Z","temp_c":3.1,"temp_f":37.6,"feels_like_c":0.1,"humidity_pct":96.9,"wind_kph":11.2,"wind_dir":"NW","condition":"cloudy"},"hourly":[],"daily":[{"date":"2026-11-21","min_c":-1.2,"max_c":3.4,"precip_mm":0.3,"condition":"cloudy"}]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"weather","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","description":"City name, optionally with region and/or country: 'Paris', 'Paris, FR', 'Springfield, IL, US'. Use q OR lat+lon."},"zip":{"type":"string","description":"US ZIP code (alternative to q), e.g. 10001"},"lat":{"type":"number","description":"Latitude -90..90 (use with lon instead of q)"},"lon":{"type":"number","description":"Longitude -180..180"},"days":{"type":"integer","description":"Daily forecast days 1-9 (default 7)"},"hours":{"type":"integer","description":"Hourly entries 0-48 (default 24)"}},"required":[]},"example":{"q":"Winnipeg, CA"}}}}},"get":{"summary":"Current weather, hourly (48h) and daily (9-day) forecast for any city name, US ZIP code or lat/lon worldwide, plus active US NWS alerts. Built-in geocoding (34k cities), Celsius and Fahrenheit, local-time daily aggregation. Data: MET Norway.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"region":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"timezone":{"type":"string"}}},"current":{"type":"object","properties":{"time":{"type":"string"},"temp_c":{"type":"number"},"temp_f":{"type":"number"},"feels_like_c":{"type":"number"},"humidity_pct":{"type":"number"},"wind_kph":{"type":"number"},"wind_dir":{"type":"string"},"condition":{"type":"string"}}},"hourly":{"type":"array","items":{}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"min_c":{"type":"number"},"max_c":{"type":"number"},"precip_mm":{"type":"number"},"condition":{"type":"string"}}}}}},"example":{"location":{"name":"Winnipeg","country":"CA","region":"Manitoba","lat":49.8844,"lon":-97.147,"timezone":"America/Winnipeg"},"current":{"time":"2026-11-21T10:00:00Z","temp_c":3.1,"temp_f":37.6,"feels_like_c":0.1,"humidity_pct":96.9,"wind_kph":11.2,"wind_dir":"NW","condition":"cloudy"},"hourly":[],"daily":[{"date":"2026-11-21","min_c":-1.2,"max_c":3.4,"precip_mm":0.3,"condition":"cloudy"}]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"weatherGet","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"City name, optionally with region and/or country: 'Paris', 'Paris, FR', 'Springfield, IL, US'. Use q OR lat+lon."},{"name":"zip","in":"query","required":false,"schema":{"type":"string"},"description":"US ZIP code (alternative to q), e.g. 10001"},{"name":"lat","in":"query","required":false,"schema":{"type":"number"},"description":"Latitude -90..90 (use with lon instead of q)"},{"name":"lon","in":"query","required":false,"schema":{"type":"number"},"description":"Longitude -180..180"},{"name":"days","in":"query","required":false,"schema":{"type":"integer"},"description":"Daily forecast days 1-9 (default 7)"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer"},"description":"Hourly entries 0-48 (default 24)"}]}},"/api/sec-company":{"post":{"summary":"US public company fundamentals from SEC EDGAR by ticker or CIK: profile (industry, exchange, fiscal year end), revenue, gross/operating/net income, diluted EPS, operating cash flow, capex, assets, liabilities, equity, cash, debt, shares outstanding (latest + up to 10 annual + 4 quarterly values), margins, free cash flow, and recent 10-K/10-Q/8-K filings with links.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.003000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"name":{"type":"string"},"cik":{"type":"number"},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"industry":{"type":"string"},"fiscal_year_end":{"type":"string"}}},"financials":{"type":"object","properties":{"revenue":{"type":"object","properties":{"concept":{"type":"string"},"unit":{"type":"string"},"latest":{"type":"object","properties":{"value":{"type":"number"},"period_start":{"type":"string"},"period_end":{"type":"string"},"form":{"type":"string"},"filed":{"type":"string"}}},"annual":{"type":"array","items":{}},"quarterly":{"type":"array","items":{}}}}}},"ratios_latest_annual":{"type":"object","properties":{"gross_margin":{"type":"number"},"net_margin":{"type":"number"}}},"recent_filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"filed":{"type":"string"},"url":{"type":"string"}}}}}},"example":{"company":{"name":"Apple Inc.","cik":320193,"tickers":["AAPL"],"exchanges":["Nasdaq"],"industry":"Electronic Computers","fiscal_year_end":"0925"},"financials":{"revenue":{"concept":"us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax","unit":"USD","latest":{"value":478834000000,"period_start":"2025-09-28","period_end":"2026-09-26","form":"10-K","filed":"2026-11-03"},"annual":[],"quarterly":[]}},"ratios_latest_annual":{"gross_margin":0.4879,"net_margin":0.25},"recent_filings":[{"form":"10-K","filed":"2026-11-03","url":"https://www.sec.gov/Archives/edgar/data/320193/..."}]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"secCompany","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"Stock ticker, e.g. AAPL, BRK.B (or use cik)"},"cik":{"type":"string","description":"SEC CIK number (alternative to ticker)"},"years":{"type":"integer","description":"Annual history length 1-10 (default 5)"},"filings":{"type":"integer","description":"Number of recent filings 0-40 (default 10)"}},"required":[]},"example":{"ticker":"AAPL"}}}}},"get":{"summary":"US public company fundamentals from SEC EDGAR by ticker or CIK: profile (industry, exchange, fiscal year end), revenue, gross/operating/net income, diluted EPS, operating cash flow, capex, assets, liabilities, equity, cash, debt, shares outstanding (latest + up to 10 annual + 4 quarterly values), margins, free cash flow, and recent 10-K/10-Q/8-K filings with links.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.003000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"name":{"type":"string"},"cik":{"type":"number"},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"industry":{"type":"string"},"fiscal_year_end":{"type":"string"}}},"financials":{"type":"object","properties":{"revenue":{"type":"object","properties":{"concept":{"type":"string"},"unit":{"type":"string"},"latest":{"type":"object","properties":{"value":{"type":"number"},"period_start":{"type":"string"},"period_end":{"type":"string"},"form":{"type":"string"},"filed":{"type":"string"}}},"annual":{"type":"array","items":{}},"quarterly":{"type":"array","items":{}}}}}},"ratios_latest_annual":{"type":"object","properties":{"gross_margin":{"type":"number"},"net_margin":{"type":"number"}}},"recent_filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"filed":{"type":"string"},"url":{"type":"string"}}}}}},"example":{"company":{"name":"Apple Inc.","cik":320193,"tickers":["AAPL"],"exchanges":["Nasdaq"],"industry":"Electronic Computers","fiscal_year_end":"0925"},"financials":{"revenue":{"concept":"us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax","unit":"USD","latest":{"value":478834000000,"period_start":"2025-09-28","period_end":"2026-09-26","form":"10-K","filed":"2026-11-03"},"annual":[],"quarterly":[]}},"ratios_latest_annual":{"gross_margin":0.4879,"net_margin":0.25},"recent_filings":[{"form":"10-K","filed":"2026-11-03","url":"https://www.sec.gov/Archives/edgar/data/320193/..."}]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"secCompanyGet","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string"},"description":"Stock ticker, e.g. AAPL, BRK.B (or use cik)"},{"name":"cik","in":"query","required":false,"schema":{"type":"string"},"description":"SEC CIK number (alternative to ticker)"},{"name":"years","in":"query","required":false,"schema":{"type":"integer"},"description":"Annual history length 1-10 (default 5)"},{"name":"filings","in":"query","required":false,"schema":{"type":"integer"},"description":"Number of recent filings 0-40 (default 10)"}]}},"/api/domain-intel":{"post":{"summary":"Company/domain enrichment from a domain, URL or email: homepage title and description, social profiles (X, LinkedIn, GitHub, etc.), email provider (Google Workspace, Microsoft 365...), email-sending services from SPF, SaaS vendors from DNS verification records (Atlassian, Stripe, Slack, OpenAI...), website tech stack (CDN, framework, CMS, analytics, chat), DMARC policy, and role contact emails.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.004000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"exists":{"type":"boolean"},"website":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"language":{"type":"string"}}},"social":{"type":"object","properties":{"twitter":{"type":"string"},"linkedin":{"type":"string"},"github":{"type":"string"}}},"email":{"type":"object","properties":{"provider":{"type":"array","items":{"type":"string"}},"dmarc_policy":{"type":"string"},"sending_services_from_spf":{"type":"array","items":{"type":"string"}}}},"saas_detected_from_dns":{"type":"array","items":{"type":"string"}},"tech_stack":{"type":"array","items":{"type":"string"}}}},"example":{"domain":"stripe.com","exists":true,"website":{"title":"Stripe | Financial Infrastructure to Grow Your Revenue","description":"Stripe is a financial services platform...","language":"en-CA"},"social":{"twitter":"https://twitter.com/stripe","linkedin":"https://www.linkedin.com/company/stripe","github":"https://github.com/stripe"},"email":{"provider":["Google Workspace"],"dmarc_policy":"reject","sending_services_from_spf":["Salesforce","Qualtrics"]},"saas_detected_from_dns":["Atlassian","Stripe"],"tech_stack":["Cloudflare","Next.js","React"]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"domainIntel","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Domain, URL or email address"}},"required":["domain"]},"example":{"domain":"stripe.com"}}}}},"get":{"summary":"Company/domain enrichment from a domain, URL or email: homepage title and description, social profiles (X, LinkedIn, GitHub, etc.), email provider (Google Workspace, Microsoft 365...), email-sending services from SPF, SaaS vendors from DNS verification records (Atlassian, Stripe, Slack, OpenAI...), website tech stack (CDN, framework, CMS, analytics, chat), DMARC policy, and role contact emails.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.004000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"exists":{"type":"boolean"},"website":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"language":{"type":"string"}}},"social":{"type":"object","properties":{"twitter":{"type":"string"},"linkedin":{"type":"string"},"github":{"type":"string"}}},"email":{"type":"object","properties":{"provider":{"type":"array","items":{"type":"string"}},"dmarc_policy":{"type":"string"},"sending_services_from_spf":{"type":"array","items":{"type":"string"}}}},"saas_detected_from_dns":{"type":"array","items":{"type":"string"}},"tech_stack":{"type":"array","items":{"type":"string"}}}},"example":{"domain":"stripe.com","exists":true,"website":{"title":"Stripe | Financial Infrastructure to Grow Your Revenue","description":"Stripe is a financial services platform...","language":"en-CA"},"social":{"twitter":"https://twitter.com/stripe","linkedin":"https://www.linkedin.com/company/stripe","github":"https://github.com/stripe"},"email":{"provider":["Google Workspace"],"dmarc_policy":"reject","sending_services_from_spf":["Salesforce","Qualtrics"]},"saas_detected_from_dns":["Atlassian","Stripe"],"tech_stack":["Cloudflare","Next.js","React"]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"domainIntelGet","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"Domain, URL or email address"}]}},"/api/x402-check":{"post":{"summary":"Check an x402 endpoint before paying it: probes it unpaid, decodes the 402 (v1 body or v2 header), validates network, asset (canonical USDC?), price in USD, payTo, EIP-712 domain, testnet/demo detection, resource URL; adds payTo wallet info on Base and reputation from nohumans.directory (incl. whether its latest real purchase delivered) and 402index. Returns verdict looks_ok / caution / do_not_pay.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"http_status":{"type":"number"},"transport":{"type":"string"},"payment_options":{"type":"array","items":{"type":"object","properties":{"network":{"type":"string"},"network_name":{"type":"string"},"asset_is_usdc":{"type":"boolean"},"price_usd":{"type":"number"},"pay_to":{"type":"string"},"eip712_domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}}},"issues":{"type":"array","items":{}}}}},"directories":{"type":"object","properties":{"nohumans":{"type":"object","properties":{"status":{"type":"string"},"paid_verified":{"type":"boolean"},"latest_purchase_delivered":{"type":"boolean"}}}}},"verdict":{"type":"string"},"problems":{"type":"array","items":{}},"warnings":{"type":"array","items":{}}}},"example":{"url":"https://api.example.com/v1/weather","http_status":402,"transport":"header (x402 v2)","payment_options":[{"network":"eip155:8453","network_name":"Base","asset_is_usdc":true,"price_usd":0.01,"pay_to":"0xCAc5...18a7","eip712_domain":{"name":"USD Coin","version":"2"},"issues":[]}],"directories":{"nohumans":{"status":"verified","paid_verified":true,"latest_purchase_delivered":true}},"verdict":"looks_ok","problems":[],"warnings":[]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"x402Check","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The x402 endpoint URL you are about to pay"},"method":{"type":"string","description":"HTTP method to probe with (default GET)"},"body":{"type":"object","description":"Optional JSON body to send when probing with POST"}},"required":["url"]},"example":{"url":"https://api.aifoundry.sh/v1/weather"}}}}},"get":{"summary":"Check an x402 endpoint before paying it: probes it unpaid, decodes the 402 (v1 body or v2 header), validates network, asset (canonical USDC?), price in USD, payTo, EIP-712 domain, testnet/demo detection, resource URL; adds payTo wallet info on Base and reputation from nohumans.directory (incl. whether its latest real purchase delivered) and 402index. Returns verdict looks_ok / caution / do_not_pay.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"http_status":{"type":"number"},"transport":{"type":"string"},"payment_options":{"type":"array","items":{"type":"object","properties":{"network":{"type":"string"},"network_name":{"type":"string"},"asset_is_usdc":{"type":"boolean"},"price_usd":{"type":"number"},"pay_to":{"type":"string"},"eip712_domain":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}}},"issues":{"type":"array","items":{}}}}},"directories":{"type":"object","properties":{"nohumans":{"type":"object","properties":{"status":{"type":"string"},"paid_verified":{"type":"boolean"},"latest_purchase_delivered":{"type":"boolean"}}}}},"verdict":{"type":"string"},"problems":{"type":"array","items":{}},"warnings":{"type":"array","items":{}}}},"example":{"url":"https://api.example.com/v1/weather","http_status":402,"transport":"header (x402 v2)","payment_options":[{"network":"eip155:8453","network_name":"Base","asset_is_usdc":true,"price_usd":0.01,"pay_to":"0xCAc5...18a7","eip712_domain":{"name":"USD Coin","version":"2"},"issues":[]}],"directories":{"nohumans":{"status":"verified","paid_verified":true,"latest_purchase_delivered":true}},"verdict":"looks_ok","problems":[],"warnings":[]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"x402CheckGet","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"The x402 endpoint URL you are about to pay"},{"name":"method","in":"query","required":false,"schema":{"type":"string"},"description":"HTTP method to probe with (default GET)"},{"name":"body","in":"query","required":false,"schema":{"type":"object"},"description":"Optional JSON body to send when probing with POST"}]}},"/api/x402-revenue":{"post":{"summary":"Does this x402 seller actually get paid? On-chain revenue for an x402 endpoint or payTo wallet on Base: USDC payments <= $1 over 30 days, distinct payers, revenue excluding directory test buyers, rank and percentile among 1,987 listed seller wallets. From Nightshift's on-chain census (snapshot date in response).","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"pay_to":{"type":"string"},"in_census":{"type":"boolean"},"payments_le_1usd_30d":{"type":"number"},"usd_received_30d":{"type":"number"},"distinct_payers_30d":{"type":"number"},"usd_excl_directory_test_buyers":{"type":"number"},"distinct_payers_excl_directory_test_buyers":{"type":"number"},"rank_by_independent_revenue":{"type":"number"},"percentile":{"type":"number"},"signal":{"type":"string"},"census":{"type":"object","properties":{"snapshot":{"type":"string"},"window_days":{"type":"number"},"wallets_in_census":{"type":"number"},"median_earner_usd":{"type":"number"}}}}},"example":{"pay_to":"0x8a5d...","in_census":true,"payments_le_1usd_30d":351,"usd_received_30d":16.59,"distinct_payers_30d":23,"usd_excl_directory_test_buyers":16.2,"distinct_payers_excl_directory_test_buyers":20,"rank_by_independent_revenue":22,"percentile":98.9,"signal":"many independent payers","census":{"snapshot":"2026-11-21","window_days":30,"wallets_in_census":1987,"median_earner_usd":0.03}}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"x402Revenue","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"x402 endpoint URL (its payTo is read from the 402)"},"payTo":{"type":"string","description":"Or: the seller's EVM payTo wallet address"}},"required":[]},"example":{"url":"https://blockrun.ai/api/v1/images/generations"}}}}},"get":{"summary":"Does this x402 seller actually get paid? On-chain revenue for an x402 endpoint or payTo wallet on Base: USDC payments <= $1 over 30 days, distinct payers, revenue excluding directory test buyers, rank and percentile among 1,987 listed seller wallets. From Nightshift's on-chain census (snapshot date in response).","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"pay_to":{"type":"string"},"in_census":{"type":"boolean"},"payments_le_1usd_30d":{"type":"number"},"usd_received_30d":{"type":"number"},"distinct_payers_30d":{"type":"number"},"usd_excl_directory_test_buyers":{"type":"number"},"distinct_payers_excl_directory_test_buyers":{"type":"number"},"rank_by_independent_revenue":{"type":"number"},"percentile":{"type":"number"},"signal":{"type":"string"},"census":{"type":"object","properties":{"snapshot":{"type":"string"},"window_days":{"type":"number"},"wallets_in_census":{"type":"number"},"median_earner_usd":{"type":"number"}}}}},"example":{"pay_to":"0x8a5d...","in_census":true,"payments_le_1usd_30d":351,"usd_received_30d":16.59,"distinct_payers_30d":23,"usd_excl_directory_test_buyers":16.2,"distinct_payers_excl_directory_test_buyers":20,"rank_by_independent_revenue":22,"percentile":98.9,"signal":"many independent payers","census":{"snapshot":"2026-11-21","window_days":30,"wallets_in_census":1987,"median_earner_usd":0.03}}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"x402RevenueGet","parameters":[{"name":"url","in":"query","required":false,"schema":{"type":"string"},"description":"x402 endpoint URL (its payTo is read from the 402)"},{"name":"payTo","in":"query","required":false,"schema":{"type":"string"},"description":"Or: the seller's EVM payTo wallet address"}]}},"/api/seller-audit":{"post":{"summary":"Audit YOUR x402 API as a seller: checks /openapi.json and /.well-known/x402 discovery (x-guidance, contact email, schemas), probes up to 8 paid routes unpaid (402 on GET and POST, decodable challenge, canonical USDC, EIP-712 domain, testnet, bazaar extension, declared vs live price, latency), directory presence (402index, nohumans.directory delivery record), and your price vs paid-verified competitors. Returns a score and a prioritized fix list.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.050000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"score":{"type":"number"},"summary":{"type":"string"},"discovery":{"type":"object","properties":{"openapi_json":{"type":"object","properties":{"found":{"type":"boolean"},"has_x_guidance":{"type":"boolean"}}}}},"routes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"status":{"type":"number"},"price_usd":{"type":"number"},"issues":{"type":"array","items":{"type":"string"}},"market":{"type":"object","properties":{"paid_verified_competitors":{"type":"number"},"median_usd":{"type":"number"}}}}}},"fixes":{"type":"array","items":{"type":"string"}}}},"example":{"origin":"https://api.example.com","score":76,"summary":"1/1 tested routes return a valid USDC x402 challenge; 1 route issues; 2 origin-level fixes.","discovery":{"openapi_json":{"found":true,"has_x_guidance":false}},"routes":[{"path":"/v1/weather","status":402,"price_usd":0.01,"issues":["priced at $0.01, over 2x the median ($0.002) of paid-verified competitors"],"market":{"paid_verified_competitors":10,"median_usd":0.002}}],"fixes":["Add info.x-guidance to /openapi.json..."]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"sellerAudit","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string","description":"Your API origin (https://api.example.com) or one endpoint URL"}},"required":["origin"]},"example":{"origin":"https://api.aifoundry.sh/v1/weather"}}}}},"get":{"summary":"Audit YOUR x402 API as a seller: checks /openapi.json and /.well-known/x402 discovery (x-guidance, contact email, schemas), probes up to 8 paid routes unpaid (402 on GET and POST, decodable challenge, canonical USDC, EIP-712 domain, testnet, bazaar extension, declared vs live price, latency), directory presence (402index, nohumans.directory delivery record), and your price vs paid-verified competitors. Returns a score and a prioritized fix list.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.050000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"score":{"type":"number"},"summary":{"type":"string"},"discovery":{"type":"object","properties":{"openapi_json":{"type":"object","properties":{"found":{"type":"boolean"},"has_x_guidance":{"type":"boolean"}}}}},"routes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"status":{"type":"number"},"price_usd":{"type":"number"},"issues":{"type":"array","items":{"type":"string"}},"market":{"type":"object","properties":{"paid_verified_competitors":{"type":"number"},"median_usd":{"type":"number"}}}}}},"fixes":{"type":"array","items":{"type":"string"}}}},"example":{"origin":"https://api.example.com","score":76,"summary":"1/1 tested routes return a valid USDC x402 challenge; 1 route issues; 2 origin-level fixes.","discovery":{"openapi_json":{"found":true,"has_x_guidance":false}},"routes":[{"path":"/v1/weather","status":402,"price_usd":0.01,"issues":["priced at $0.01, over 2x the median ($0.002) of paid-verified competitors"],"market":{"paid_verified_competitors":10,"median_usd":0.002}}],"fixes":["Add info.x-guidance to /openapi.json..."]}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"sellerAuditGet","parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string"},"description":"Your API origin (https://api.example.com) or one endpoint URL"}]}},"/api/email-check":{"post":{"summary":"Validate an email address before sending: syntax, domain exists, MX records, null-MX, SPF, DMARC policy, disposable-provider detection (10k+ domains), role address, free provider, plus an overall verdict. DNS-level, no SMTP probe.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"verdict":{"type":"string"},"domain_exists":{"type":"boolean"},"accepts_mail":{"type":"boolean"},"mx":{"type":"array","items":{"type":"object","properties":{"priority":{"type":"number"},"host":{"type":"string"}}}},"spf":{"type":"string"},"dmarc_policy":{"type":"string"},"disposable":{"type":"boolean"},"role_address":{"type":"boolean"},"free_provider":{"type":"boolean"}}},"example":{"email":"someone@gmail.com","verdict":"deliverable_likely","domain_exists":true,"accepts_mail":true,"mx":[{"priority":5,"host":"gmail-smtp-in.l.google.com"}],"spf":"v=spf1 redirect=_spf.google.com","dmarc_policy":"none","disposable":false,"role_address":false,"free_provider":true}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"emailCheck","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Email address to check"}},"required":["email"]},"example":{"email":"someone@gmail.com"}}}}},"get":{"summary":"Validate an email address before sending: syntax, domain exists, MX records, null-MX, SPF, DMARC policy, disposable-provider detection (10k+ domains), role address, free provider, plus an overall verdict. DNS-level, no SMTP probe.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"verdict":{"type":"string"},"domain_exists":{"type":"boolean"},"accepts_mail":{"type":"boolean"},"mx":{"type":"array","items":{"type":"object","properties":{"priority":{"type":"number"},"host":{"type":"string"}}}},"spf":{"type":"string"},"dmarc_policy":{"type":"string"},"disposable":{"type":"boolean"},"role_address":{"type":"boolean"},"free_provider":{"type":"boolean"}}},"example":{"email":"someone@gmail.com","verdict":"deliverable_likely","domain_exists":true,"accepts_mail":true,"mx":[{"priority":5,"host":"gmail-smtp-in.l.google.com"}],"spf":"v=spf1 redirect=_spf.google.com","dmarc_policy":"none","disposable":false,"role_address":false,"free_provider":true}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"emailCheckGet","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string"},"description":"Email address to check"}]}},"/api/dns":{"post":{"summary":"DNS lookup for a domain: A, AAAA, MX, NS, TXT, CNAME, CAA, SOA (all by default, or pick with type=MX,TXT), plus parsed SPF and DMARC. Resolved over DNS-over-HTTPS (1.1.1.1).","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"rcode":{"type":"string"},"exists":{"type":"boolean"},"records":{"type":"object","properties":{"A":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"ttl":{"type":"number"},"data":{"type":"string"}}}},"MX":{"type":"array","items":{}}}},"email":{"type":"object","properties":{"spf":{"type":"string"},"dmarc":{"type":"string"}}}}},"example":{"domain":"example.com","rcode":"NOERROR","exists":true,"records":{"A":[{"type":"A","ttl":300,"data":"93.184.215.14"}],"MX":[]},"email":{"spf":"v=spf1 -all","dmarc":"v=DMARC1;p=reject;sp=reject;adkim=s;aspf=s"}}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"dns","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Domain name"},"type":{"type":"string","description":"Optional comma list of record types: A,AAAA,MX,NS,TXT,CNAME,CAA,SOA"}},"required":["domain"]},"example":{"domain":"example.com"}}}}},"get":{"summary":"DNS lookup for a domain: A, AAAA, MX, NS, TXT, CNAME, CAA, SOA (all by default, or pick with type=MX,TXT), plus parsed SPF and DMARC. Resolved over DNS-over-HTTPS (1.1.1.1).","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"rcode":{"type":"string"},"exists":{"type":"boolean"},"records":{"type":"object","properties":{"A":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"ttl":{"type":"number"},"data":{"type":"string"}}}},"MX":{"type":"array","items":{}}}},"email":{"type":"object","properties":{"spf":{"type":"string"},"dmarc":{"type":"string"}}}}},"example":{"domain":"example.com","rcode":"NOERROR","exists":true,"records":{"A":[{"type":"A","ttl":300,"data":"93.184.215.14"}],"MX":[]},"email":{"spf":"v=spf1 -all","dmarc":"v=DMARC1;p=reject;sp=reject;adkim=s;aspf=s"}}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"dnsGet","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"Domain name"},{"name":"type","in":"query","required":false,"schema":{"type":"string"},"description":"Optional comma list of record types: A,AAAA,MX,NS,TXT,CNAME,CAA,SOA"}]}},"/api/extract":{"post":{"summary":"Fetch any public URL and return clean markdown of the main content, plus extracted links and page metadata. Built for LLM agents.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"href":{"type":"string"}}}},"meta":{"type":"object","properties":{"description":{}}}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain\n\nThis domain is for use in illustrative examples...","links":[{"text":"More information...","href":"https://www.iana.org/domains/example"}],"meta":{"description":null}}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"extract","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public http(s) URL to fetch"}},"required":["url"]},"example":{"url":"https://example.com"}}}}},"get":{"summary":"Fetch any public URL and return clean markdown of the main content, plus extracted links and page metadata. Built for LLM agents.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.002000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"href":{"type":"string"}}}},"meta":{"type":"object","properties":{"description":{}}}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain\n\nThis domain is for use in illustrative examples...","links":[{"text":"More information...","href":"https://www.iana.org/domains/example"}],"meta":{"description":null}}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"extractGet","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"Public http(s) URL to fetch"}]}},"/api/meta":{"post":{"summary":"Fetch a public URL and return its title, description, canonical URL, OpenGraph and Twitter card tags, favicon, final URL and HTTP status.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"finalUrl":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"og":{"type":"object","properties":{}},"twitter":{"type":"object","properties":{}},"favicon":{"type":"string"}}},"example":{"url":"https://example.com","finalUrl":"https://example.com/","status":200,"title":"Example Domain","og":{},"twitter":{},"favicon":"https://example.com/favicon.ico"}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"meta","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public http(s) URL to fetch"}},"required":["url"]},"example":{"url":"https://example.com"}}}}},"get":{"summary":"Fetch a public URL and return its title, description, canonical URL, OpenGraph and Twitter card tags, favicon, final URL and HTTP status.","tags":["Nightshift"],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.001000"}},"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"finalUrl":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"og":{"type":"object","properties":{}},"twitter":{"type":"object","properties":{}},"favicon":{"type":"string"}}},"example":{"url":"https://example.com","finalUrl":"https://example.com/","status":200,"title":"Example Domain","og":{},"twitter":{},"favicon":"https://example.com/favicon.ico"}}}},"400":{"description":"Bad input (not charged)"},"402":{"description":"Payment Required (x402, USDC on Base)"}},"operationId":"metaGet","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"Public http(s) URL to fetch"}]}}}}