{"openapi":"3.1.0","info":{"title":"x402 Tool Shop","version":"1.0.0","description":"Pay-per-call APIs for AI agents, paid in USDC over x402. No accounts or API keys. Errors and bad input are never charged; every operation has a free sample.","contact":{"url":"https://x402toolshop.com/"}},"servers":[{"url":"https://api.x402toolshop.com"}],"externalDocs":{"description":"llms.txt","url":"https://api.x402toolshop.com/llms.txt"},"x-mcp":{"url":"https://api.x402toolshop.com/mcp","transport":"streamable-http"},"paths":{"/v1/clinical":{"get":{"operationId":"clinical_calculator","summary":"Clinical Calculators","description":"Clinical calculator: standard medical formulas in one call: bmi, bsa, egfr, crcl, cha2ds2_vasc, has_bled, map, corrected_calcium, anion_gap, qtc, ldl_friedewald. Pick one with calc=, pass its inputs (kg/lb and cm/in accepted); returns the result, unit, interpretation band and the formula's published reference. Inputs are range-checked; errors are never charged.","tags":["clinical","medical","calculator","egfr","bmi"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.004"},"free_sample":"https://api.x402toolshop.com/sample/clinical-calculator"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"result":{},"unit":{"type":"string"},"interpretation":{"type":"string"},"formula_reference":{"type":"string"}}},"example":{"calculator":"egfr","title":"eGFR, CKD-EPI 2021 creatinine (race-free)","result":57,"unit":"mL/min/1.73m2","interpretation":"KDIGO GFR category G3a (mildly to moderately decreased)","formula_reference":"Inker LA et al. N Engl J Med 2021;385:1737-49","note":"Educational / clinician decision support only, not medical advice. Verify inputs and use clinical judgment."}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.004 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"parameters":[{"name":"calc","in":"query","required":true,"description":"One of: bmi, bsa, egfr, crcl, cha2ds2_vasc, has_bled, map, corrected_calcium, anion_gap, qtc, ldl_friedewald","schema":{"type":"string"},"example":"egfr"},{"name":"weight_kg","in":"query","required":false,"schema":{"type":"number"}},{"name":"weight_lb","in":"query","required":false,"schema":{"type":"number"}},{"name":"height_cm","in":"query","required":false,"schema":{"type":"number"}},{"name":"height_in","in":"query","required":false,"schema":{"type":"number"}},{"name":"age","in":"query","required":false,"description":"years","schema":{"type":"number"},"example":62},{"name":"sex","in":"query","required":false,"description":"female or male","schema":{"type":"string"},"example":"female"},{"name":"creatinine_mg_dl","in":"query","required":false,"schema":{"type":"number"},"example":1.1},{"name":"systolic","in":"query","required":false,"schema":{"type":"number"}},{"name":"diastolic","in":"query","required":false,"schema":{"type":"number"}},{"name":"calcium_mg_dl","in":"query","required":false,"schema":{"type":"number"}},{"name":"albumin_g_dl","in":"query","required":false,"schema":{"type":"number"}},{"name":"sodium","in":"query","required":false,"schema":{"type":"number"}},{"name":"chloride","in":"query","required":false,"schema":{"type":"number"}},{"name":"bicarbonate","in":"query","required":false,"schema":{"type":"number"}},{"name":"qt_ms","in":"query","required":false,"schema":{"type":"number"}},{"name":"heart_rate","in":"query","required":false,"schema":{"type":"number"}},{"name":"total_cholesterol","in":"query","required":false,"schema":{"type":"number"}},{"name":"hdl","in":"query","required":false,"schema":{"type":"number"}},{"name":"triglycerides","in":"query","required":false,"schema":{"type":"number"}},{"name":"chf","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"hypertension","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"diabetes","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"stroke_tia","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"vascular","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"abnormal_renal","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"abnormal_liver","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"stroke","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"bleeding","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"labile_inr","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"elderly","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"drugs","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"alcohol","in":"query","required":false,"schema":{"type":"boolean"}}]}},"/v1/csv-preflight":{"post":{"operationId":"csv_preflight","summary":"CSV Preflight Check","description":"CSV preflight: validate a CSV before import and find every load error first. Detects the delimiter, line endings, BOM and encoding damage, header problems (blank or duplicate names), rows with the wrong field count (with line numbers), unterminated quotes, duplicate rows, and per-column type, empty rate and mixed or ambiguous values. Returns ready true/false plus every issue. POST JSON {csv}, up to 1.5 MB.","tags":["csv","csv-validation","preflight","data-quality","import"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"free_sample":"https://api.x402toolshop.com/sample/csv-preflight"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"ready":{"type":"boolean"},"delimiter":{"type":"string"},"rows":{"type":"number"},"columns":{"type":"array"},"issues":{"type":"array"}}},"example":{"ready":false,"delimiter":"comma","line_endings":"LF","has_header":true,"rows":4,"columns_count":4,"columns":[{"name":"id","type":"integer","empty_pct":0,"distinct":4,"examples":["1","2","3"]},{"name":"name","type":"text","empty_pct":0,"distinct":4,"examples":["Ada","Grace","Linus"]},{"name":"signup_date","type":"date","empty_pct":0,"distinct":4,"examples":["2026-01-04","2026-02-11","03/04/2026"],"mixed_types":{"date":3,"date_us":1}},{"name":"score","type":"decimal","empty_pct":25,"distinct":4,"examples":["91.5","88","x"],"mixed_types":{"decimal":1,"integer":1,"text":1,"empty":1}}],"issues":[{"severity":"error","code":"ragged_rows","message":"1 row(s) do not have 4 fields","examples":[{"line":5,"fields":3}]},{"severity":"warning","code":"mixed_types","message":"column \"signup_date\" mixes date and date_us"},{"severity":"warning","code":"ambiguous_dates","message":"column \"signup_date\" has dates like 03/04/2025 (month/day order is ambiguous)"},{"severity":"warning","code":"mixed_types","message":"column \"score\" mixes decimal and integer and text"}]}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.005 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"csv":{"type":"string","description":"The CSV text (up to 1.5 MB)"},"delimiter":{"type":"string","description":"Optional: ',', ';', 'tab' or '|' (detected if omitted)"},"has_header":{"type":"boolean","description":"Optional: whether row 1 is a header (detected if omitted)"}},"required":["csv"]},"example":{"csv":"id,name,signup_date,score\n1,Ada,2026-01-04,91.5\n2,Grace,2026-02-11,88\n3,Linus,03/04/2026,x\n4,Alan,2026-03-09\n"}}}}}},"/v1/dns":{"get":{"operationId":"dns_lookup","summary":"DNS Lookup + Mail Policy","description":"DNS lookup for any domain: A, AAAA, MX, NS, TXT, CNAME, CAA and SOA records in one call, plus the domain's email DNS (SPF and DMARC policy) read out plainly. Or ask for one record type. Resolved live through three public resolvers with automatic fallback.","tags":["dns","dns-lookup","mx","spf-dmarc","domain"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"free_sample":"https://api.x402toolshop.com/sample/dns-lookup"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"records":{"type":"object"},"mail":{"type":"object"},"resolved_at":{"type":"string"}}},"example":{"domain":"example.com","records":{"A":["93.184.215.14"],"AAAA":[],"MX":[{"exchange":"mail.example.com","priority":10}],"NS":["a.iana-servers.net"],"TXT":["v=spf1 -all"],"CNAME":[],"CAA":[],"SOA":{"nsname":"ns.icann.org","hostmaster":"noc.dns.icann.org","serial":2024081500}},"mail":{"spf":{"present":true,"record":"v=spf1 -all","all":"-all","problem":null},"dmarc":{"present":true,"policy":"reject","record":"v=DMARC1;p=reject","reports_to":null},"accepts_mail":true},"resolved_at":"2026-11-17T21:00:00.000Z"}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.003 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"parameters":[{"name":"domain","in":"query","required":true,"description":"Domain name, e.g. example.com (a URL is accepted; the host is used)","schema":{"type":"string"},"example":"example.com"},{"name":"type","in":"query","required":false,"description":"Optional single record type: A, AAAA, MX, TXT, NS, CNAME, CAA, SOA","schema":{"type":"string"}}]}},"/v1/email-check":{"get":{"operationId":"email_check","summary":"Email Address Check","description":"Email validation and verification before sending: is this address likely deliverable? Checks syntax, the domain's mail servers (MX), SPF and DMARC, role addresses (info@, sales@) and disposable email providers, and returns a verdict with reasons. Never contacts the mailbox.","tags":["email-validation","email-verification","disposable-email","deliverability","mx"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"free_sample":"https://api.x402toolshop.com/sample/email-check"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"verdict":{"type":"string"},"reasons":{"type":"array"},"checks":{"type":"object"}}},"example":{"email":"jane@example.com","verdict":"deliverable_likely","reasons":[],"checks":{"syntax":true,"domain_has_mail_servers":true,"mail_servers":["mail.example.com"],"role_address":false,"disposable_domain":false,"spf":true,"dmarc_policy":"reject"},"note":"No message or SMTP probe was sent; mailbox existence is not confirmed."}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.005 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"parameters":[{"name":"email","in":"query","required":true,"description":"The address to check","schema":{"type":"string"},"example":"jane@example.com"}]}},"/v1/event-weather":{"get":{"operationId":"event_weather","summary":"Event Weather US","description":"Weather for a game, stadium or concert: will weather affect this event? Hourly rain chance, wind, temperature and active alerts for the hours of a US sports or concert event, with roof type (dome, retractable, open) so indoor events say so. Name the venue, team or coordinates and the start time (up to ~6 days out). Source: NOAA National Weather Service. Every forecast is graded against official observations; record at https://api.x402toolshop.com/track-record/event-weather","tags":["weather","events","sports","forecast","concerts"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"free_sample":"https://api.x402toolshop.com/sample/event-weather"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object"},"exposure":{"type":"string"},"weather_matters":{"type":"boolean"},"summary":{"type":"string"},"rain":{"type":"object"},"wind":{"type":"object"},"temperature_f":{"type":"object"},"hourly":{"type":"array"},"alerts":{"type":"array"},"forecast":{"type":"object"}}},"example":{"answer_id":"4f6c…","event":{"title":"Green Bay Packers at Detroit Lions","venue":"Lambeau Field","city":"Green Bay, WI","start":"2026-11-23T12:00-06:00","end":"2026-11-23T15:00-06:00","schedule_status":"scheduled"},"exposure":"outdoors","weather_matters":true,"summary":"Rain likely (60% at worst). Wind up to 18 mph. 34–38°F.","rain":{"max_chance_pct":60,"likely":true},"wind":{"max_mph":18},"temperature_f":{"min":34,"max":38},"hourly":[{"start":"2026-11-23T12:00-06:00","temp_f":34,"rain_chance_pct":40,"wind_mph":15,"wind_direction":"NW","conditions":"Chance Rain"}],"alerts":[],"forecast":{"source":"NOAA National Weather Service","issued_at":"2026-11-21T14:05:00Z","hours_ahead":46}}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.02 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"parameters":[{"name":"venue","in":"query","required":false,"description":"Venue name, venue id, or home team (e.g. 'Lambeau Field', 'Green Bay Packers')","schema":{"type":"string"},"example":"Lambeau Field"},{"name":"event","in":"query","required":false,"description":"Instead of venue+start: an event from our schedule, e.g. 'Packers at Lions'","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude for any other outdoor US location (use with lon)","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"Longitude (use with lat)","schema":{"type":"number"}},{"name":"start","in":"query","required":false,"description":"Start time, ISO 8601. Without an offset it is read as local time at the venue.","schema":{"type":"string"}},{"name":"in_hours","in":"query","required":false,"description":"Instead of start: the event starts this many hours from now (0-150)","schema":{"type":"number"},"example":24},{"name":"hours","in":"query","required":false,"description":"Event length in hours, 1–12 (default 3)","schema":{"type":"number"},"example":3}]}},"/v1/sanctions":{"get":{"operationId":"sanctions_screen","summary":"OFAC Sanctions Screening","description":"OFAC sanctions screening for a company or person name (fuzzy, aliases included) and/or a crypto wallet address, e.g. a counterparty or payTo wallet before paying it. Checked against the US Treasury OFAC SDN list (names plus 1,000+ listed wallets), refreshed daily. Returns match / possible_match / no_match with the listed entries and programs. Refuses rather than answers if the list is stale.","tags":["sanctions","ofac","wallet-screening","kyc","compliance"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.008"},"free_sample":"https://api.x402toolshop.com/sample/sanctions-screen"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":"string"},"matches":{"type":"array"},"address_match":{},"list":{"type":"object"}}},"example":{"query":{"name":"Banco Nacional de Cuba"},"verdict":"match","matches":[{"score":1,"matched_name":"BANCO NACIONAL DE CUBA","sdn_name":"BANCO NACIONAL DE CUBA","type":"entity","programs":["CUBA"],"also_known_as":["NATIONAL BANK OF CUBA"],"ofac_id":"306"}],"address_match":null,"list":{"source":"US Treasury OFAC Specially Designated Nationals (SDN) list","published":"2026-11-13T16:33:06.000Z","entries":19565,"wallet_addresses":1062},"note":"Screening aid, not legal advice. A possible match needs human review."}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.008 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"parameters":[{"name":"name","in":"query","required":false,"description":"Person or company name to screen","schema":{"type":"string"},"example":"Banco Nacional de Cuba"},{"name":"address","in":"query","required":false,"description":"Crypto wallet address to screen (any chain OFAC lists)","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Optional: only match this SDN type (individual, entity, vessel, aircraft)","schema":{"type":"string"}},{"name":"min_score","in":"query","required":false,"description":"Optional name-match threshold 0.7-1 (default 0.82)","schema":{"type":"number"}}]}},"/v1/weather":{"get":{"operationId":"weather_forecast","summary":"US Weather Forecast","description":"Weather forecast by city: current weather, hour by hour, and the 7-day forecast for any US city ('Goshen, IN'), ZIP code or coordinates, plus active weather alerts. Source: NOAA National Weather Service, cached briefly so answers come back fast.","tags":["weather","weather-forecast","weather-alerts","city","noaa"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"free_sample":"https://api.x402toolshop.com/sample/weather-forecast"},"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"object"},"now":{"type":"object"},"hourly":{"type":"array"},"daily":{"type":"array"},"alerts":{"type":"array"},"forecast":{"type":"object"}}},"example":{"location":{"name":"Goshen","state":"IN","lat":41.5739,"lon":-85.83,"matched_by":"place+state"},"now":{"temp_f":41,"conditions":"Mostly Cloudy","wind_mph":10,"wind_direction":"SW","rain_chance_pct":10},"hourly":[{"start":"2026-11-17T18:00-05:00","temp_f":41,"rain_chance_pct":10,"wind_mph":10,"conditions":"Mostly Cloudy"}],"daily":[{"name":"Tonight","temp_f":33,"rain_chance_pct":20,"wind_mph":10,"conditions":"Chance Light Rain","detail":"A chance of light rain after 1am..."}],"alerts":[],"forecast":{"source":"NOAA National Weather Service","issued_at":"2026-11-17T21:05:00Z"}}}}},"400":{"description":"Bad input (never charged)"},"402":{"description":"Payment required: $0.003 USDC per call over x402. The PAYMENT-REQUIRED header carries the terms; retry with a PAYMENT-SIGNATURE header."},"404":{"description":"Unknown place, venue or domain (never charged)"}},"parameters":[{"name":"location","in":"query","required":false,"description":"'City, ST', 'City, State' or a 5-digit ZIP","schema":{"type":"string"},"example":"Goshen, IN"},{"name":"lat","in":"query","required":false,"description":"Latitude (instead of location)","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"Longitude (instead of location)","schema":{"type":"number"}},{"name":"hours","in":"query","required":false,"description":"Hourly rows to return, 0-48 (default 12)","schema":{"type":"number"}},{"name":"days","in":"query","required":false,"description":"Days of forecast, 1-7 (default 7)","schema":{"type":"number"}}]}}}}