{"openapi":"3.0.3","info":{"title":"Agent Utility Suite","version":"1.0.0","x-guidance":"Free: POST /api/v1/sec-list-filings (sec_list_filings) lists a company's SEC filings, each with the exact paid call that reads it. Paid: POST /api/v1/sec-filing-section (sec_filing_section, $0.02) with JSON body like {\"ticker\":\"AAPL\",\"section\":\"risk_factors\",\"form\":\"10-K\"}; POST /api/v1/sec-recent-events (sec_recent_events, $0.02) with JSON body like {\"ticker\":\"AAPL\",\"items\":[\"2.02\"],\"limit\":1}; POST /api/v1/scrape-markdown (scrape_markdown, $0.005) with JSON body like {\"url\":\"https://example.com\"}; POST /api/v1/domain-enrich (domain_enrich, $0.005) with JSON body like {\"domain\":\"stripe.com\"}. Each paid call first returns 402 with an x402 v2 PAYMENT-REQUIRED challenge; pay in USDC on Base and retry with PAYMENT-SIGNATURE (@x402/fetch does this automatically). Invalid input returns 400 and is never charged.","contact":{"email":"vanakenventures2356@gmail.com"},"description":"SEC filings and web data for AI agents: read any section of a US public company's 10-K or 10-Q (risk factors, MD&A, …) since 2001, its latest 8-K events and press releases, and a free index of its filings; turn any web page into clean Markdown; profile a domain's email setup. No accounts or API keys: pay per call in USDC with x402. Discovery endpoints are free; paid endpoints use the x402 v2 protocol with USDC on Base. Call a paid endpoint, receive 402 with a PAYMENT-REQUIRED header, sign the payment, and retry with PAYMENT-SIGNATURE. Libraries such as @x402/fetch do this transparently."},"servers":[{"url":"https://x402-agent-api.onrender.com"}],"tags":[{"name":"discovery","description":"Free endpoints for health and capability discovery."},{"name":"free","description":"Free tools (no payment; rate-limited per client)."},{"name":"paid","description":"x402-protected endpoints, billed per call in USDC."}],"paths":{"/health":{"get":{"operationId":"get_health","summary":"Liveness check (free).","tags":["discovery"],"security":[],"x-x402":{"price":"$0","free":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["status","timestamp"],"properties":{"status":{"type":"string","enum":["ok"]},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/openapi.json":{"get":{"operationId":"get_openapi","summary":"This OpenAPI 3.0 document (free).","tags":["discovery"],"security":[],"x-x402":{"price":"$0","free":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp.json":{"get":{"operationId":"get_mcp_manifest","summary":"MCP tool manifest for agent auto-discovery (free).","tags":["discovery"],"security":[],"x-x402":{"price":"$0","free":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/":{"get":{"operationId":"get_service_index","summary":"Service index linking every discovery document (free).","tags":["discovery"],"security":[],"x-x402":{"price":"$0","free":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"operationId":"get_llms_txt","summary":"Plain-text summary for LLM agents, llms.txt convention (free).","tags":["discovery"],"security":[],"x-x402":{"price":"$0","free":true},"responses":{"200":{"description":"OK","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/sec-list-filings":{"post":{"operationId":"sec_list_filings","summary":"Free: a company's 10-K, 10-Q and 8-K filings with dates, sections and event types, each with the paid call that reads it.","description":"Free, no payment needed. Lists a US public company's 10-K (annual), 10-Q (quarterly) and 8-K (material event) filings from SEC EDGAR, newest first: filing date, fiscal year and period, sec.gov link, the sections sec_filing_section can extract from each report (Risk Factors, MD&A, Business, Legal Proceedings, Market Risk, Cybersecurity), and the event items of each 8-K (earnings 2.02, executive changes 5.02, deals 1.01, cybersecurity incidents 1.05, …). Every filing carries `next_call`: the exact paid tool call, with arguments and price, that returns its text. Use it to check what exists before paying, to find a specific year or event, or to track new filings. Filter by form and date (back to 2001); up to 50 filings per call. Look up by stock ticker or CIK. Rate-limited per client.","tags":["free"],"security":[],"x-x402":{"price":"$0","free":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this or `cik`.","type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"},"cik":{"description":"SEC Central Index Key, e.g. 320193. Use this or `ticker`.","anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","minimum":0,"exclusiveMinimum":true,"maximum":9007199254740991}]},"forms":{"description":"Which filings to list: 10-K (annual), 10-Q (quarterly), 8-K (material events). Default: all three.","minItems":1,"type":"array","items":{"type":"string","enum":["10-K","10-Q","8-K"]}},"since":{"description":"Only filings filed on or after this date (YYYY-MM-DD). Reaches back to 2001.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"limit":{"default":20,"description":"How many filings to return, newest first (1-50, default 20).","type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"example":{"ticker":"AAPL","forms":["10-K","8-K"],"limit":2}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"nullable":true,"type":"string"},"cik":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string","enum":["10-K","10-Q","8-K"]},"form_type":{"type":"string","description":"EDGAR form type, e.g. 10-K405 or 8-K/A."},"filing_date":{"type":"string"},"period_of_report":{"nullable":true,"description":"For 10-K/10-Q, the fiscal period end; for 8-K, the event date.","type":"string"},"fiscal_year":{"nullable":true,"description":"For 10-K/10-Q, the calendar year the fiscal period ends in (sec_filing_section `fiscal_year`).","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accession_number":{"type":"string"},"filing_url":{"type":"string"},"sections":{"type":"array","items":{"type":"string"},"description":"For 10-K/10-Q, the sections sec_filing_section can extract."},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"}},"required":["code","title"],"additionalProperties":false},"description":"For 8-K, the reported event items."},"next_call":{"type":"object","properties":{"tool":{"type":"string","enum":["sec_filing_section","sec_recent_events"]},"price":{"type":"string"},"arguments":{"type":"object","additionalProperties":{}}},"required":["tool","price","arguments"],"additionalProperties":false,"description":"The paid call that reads this filing. For 10-K/10-Q, change `section` to any of `sections`."}},"required":["form","form_type","filing_date","period_of_report","fiscal_year","accession_number","filing_url","sections","items","next_call"],"additionalProperties":false}},"source":{"type":"string","enum":["sec-edgar"]}},"required":["company","ticker","cik","count","filings","source"],"additionalProperties":false}}}},"400":{"description":"Invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Company or filings not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit reached (30 calls per minute per client); see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"SEC EDGAR unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sec-filing-section":{"post":{"operationId":"sec_filing_section","summary":"Read one section of a company's 10-K or 10-Q (risk factors, MD&A, business, legal, market risk, cybersecurity), any year since 2001, as clean text.","description":"Answers questions like \"What are Tesla's risk factors?\", \"What did Apple's MD&A say about margins?\" or \"How has Microsoft's cybersecurity disclosure changed since 2023?\". Returns exactly one section of a US public company's 10-K (annual) or 10-Q (quarterly) report from SEC EDGAR as clean text, ready for an LLM: Risk Factors (Item 1A), Management's Discussion and Analysis (MD&A), Business, Legal Proceedings, Market Risk, or Cybersecurity. Look up by stock ticker or CIK. Defaults to the latest filing; pass `fiscal_year` (2001 on) for an earlier year's report, e.g. to compare how risk factors changed, or `accession_number` for an exact filing (the free sec_list_filings tool lists them, with the sections each one has). The table of contents, page numbers, hidden XBRL data and HTML are removed; tables are kept as readable rows. Includes the filing date, fiscal period, accession number and sec.gov link for citation. Use it for investment research, due diligence, competitor analysis or risk monitoring without downloading a 100-page filing. Sections up to 200,000 characters. If the filing's item only points elsewhere (\"See Note 12\"), you get 404 SECTION_INCORPORATED_BY_REFERENCE with that pointer, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.02 USDC per call via x402.","tags":["paid"],"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"x-x402":{"x402Version":2,"scheme":"exact","network":"eip155:8453","networkName":"Base","price":"$0.02","currency":"USD","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"amount":"20000","payTo":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this or `cik`.","type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"},"cik":{"description":"SEC Central Index Key, e.g. 320193. Use this or `ticker`.","anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","minimum":0,"exclusiveMinimum":true,"maximum":9007199254740991}]},"section":{"type":"string","enum":["business","risk_factors","cybersecurity","legal_proceedings","mda","market_risk"],"description":"Which section to return: risk_factors, mda (Management's Discussion and Analysis), business, legal_proceedings, market_risk, or cybersecurity (10-K only, filings from late 2023 on)."},"form":{"description":"Annual report (10-K, the default) or quarterly report (10-Q). With `accession_number`, taken from that filing.","type":"string","enum":["10-K","10-Q"]},"fiscal_year":{"description":"Return the report whose fiscal period ends in this calendar year instead of the latest one, e.g. 2022 for Apple's 10-K for the year ended September 24, 2022. For a 10-Q, the latest quarter ending in that year. EDGAR has HTML filings from 2001 on.","type":"integer","minimum":2001,"maximum":2100},"accession_number":{"description":"Return the section from this exact 10-K or 10-Q filing of the company, e.g. 0000320193-22-000108.","type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$"}},"required":["section"],"additionalProperties":false},"example":{"ticker":"AAPL","section":"risk_factors","form":"10-K"}}}},"responses":{"200":{"description":"Success. Payment of $0.02 USDC was settled.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 JSON settlement receipt (transaction hash, payer, network).","schema":{"type":"string"}},"X-PAYMENT-RESPONSE":{"description":"Alias of PAYMENT-RESPONSE.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"nullable":true,"type":"string"},"cik":{"type":"string"},"form":{"type":"string","enum":["10-K","10-Q"]},"filing_date":{"type":"string","description":"Date the filing was submitted (YYYY-MM-DD)."},"period_of_report":{"nullable":true,"description":"Fiscal period end the filing covers (YYYY-MM-DD).","type":"string"},"accession_number":{"type":"string"},"filing_url":{"type":"string","description":"Link to the filing document on sec.gov."},"section":{"type":"string"},"item":{"type":"string","description":"Item number in the filing, e.g. 1A."},"section_title":{"type":"string"},"text":{"type":"string","description":"Section text, cleaned of HTML, with paragraph breaks preserved."},"char_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"word_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated":{"type":"boolean","description":"True if the section exceeded 200,000 characters and was cut."},"source":{"type":"string","enum":["sec-edgar"]}},"required":["company","ticker","cik","form","filing_date","period_of_report","accession_number","filing_url","section","item","section_title","text","char_count","word_count","truncated","source"],"additionalProperties":false}}}},"400":{"description":"Invalid input. Checked after payment verification; the payment is not settled, so nothing is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required ($0.02 USDC on Base), or the supplied payment was rejected.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 PaymentRequired object.","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Alias of PAYMENT-REQUIRED.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Payment facilitator unavailable; no payment was taken.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sec-recent-events":{"post":{"operationId":"sec_recent_events","summary":"What happened at a company lately: its latest 8-K events (earnings, CEO/CFO changes, deals, cyber incidents) with full text and press releases.","description":"Answers \"What happened at this company lately?\": did the CEO or CFO leave, what were the latest earnings, was there an acquisition, major contract or cyber incident. Returns a US public company's most recent 8-K filings from SEC EDGAR, newest first: the material events companies must report within four business days, such as earnings releases (Item 2.02), CEO, CFO and director changes (5.02), material agreements and acquisitions (1.01, 2.01), cybersecurity incidents (1.05), impairments, auditor changes and shareholder votes. Each event has its item codes with official titles, the 8-K text as clean prose, and the text of its press-release exhibits (EX-99), e.g. the full earnings release. Filter by item codes and filing date, or ask for one exact 8-K by `accession_number` (the free sec_list_filings tool lists them); up to 10 events per call. Look up by stock ticker or CIK. Use it for event monitoring, news and earnings agents, due diligence or trading research, with sec.gov links for citation. If no 8-K matches, you get 404 FILING_NOT_FOUND, free. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.02 USDC per call via x402.","tags":["paid"],"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"x-x402":{"x402Version":2,"scheme":"exact","network":"eip155:8453","networkName":"Base","price":"$0.02","currency":"USD","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"amount":"20000","payTo":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this or `cik`.","type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"},"cik":{"description":"SEC Central Index Key, e.g. 320193. Use this or `ticker`.","anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","minimum":0,"exclusiveMinimum":true,"maximum":9007199254740991}]},"items":{"description":"Only events reporting one of these 8-K items, e.g. [\"5.02\"] for executive and director changes, [\"2.02\"] for earnings releases, [\"1.01\", \"2.01\"] for deals, [\"1.05\"] for cybersecurity incidents.","minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^\\d\\.\\d{2}$"}},"since":{"description":"Only events filed on or after this date (YYYY-MM-DD).","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"accession_number":{"description":"Return only this 8-K, e.g. one found with the free sec_list_filings tool.","type":"string","pattern":"^\\d{10}-\\d{2}-\\d{6}$"},"limit":{"default":5,"description":"How many events to return, newest first (1-10, default 5).","type":"integer","minimum":1,"maximum":10},"include_exhibits":{"default":true,"description":"Include the text of press-release exhibits (EX-99), e.g. the earnings release. Default true.","type":"boolean"}},"additionalProperties":false},"example":{"ticker":"AAPL","items":["2.02"],"limit":1}}}},"responses":{"200":{"description":"Success. Payment of $0.02 USDC was settled.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 JSON settlement receipt (transaction hash, payer, network).","schema":{"type":"string"}},"X-PAYMENT-RESPONSE":{"description":"Alias of PAYMENT-RESPONSE.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"nullable":true,"type":"string"},"cik":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"events":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string","enum":["8-K","8-K/A"]},"filing_date":{"type":"string","description":"Date the 8-K was filed (YYYY-MM-DD)."},"event_date":{"nullable":true,"description":"Date of the reported event (YYYY-MM-DD).","type":"string"},"accession_number":{"type":"string"},"filing_url":{"type":"string","description":"Link to the 8-K document on sec.gov."},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"}},"required":["code","title"],"additionalProperties":false}},"text":{"type":"string","description":"The 8-K's item disclosures as clean text, from the first Item heading to the signatures."},"truncated":{"type":"boolean"},"exhibits":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Exhibit type, e.g. EX-99.1."},"description":{"nullable":true,"type":"string"},"url":{"type":"string"},"text":{"type":"string"},"truncated":{"type":"boolean"}},"required":["type","description","url","text","truncated"],"additionalProperties":false}}},"required":["form","filing_date","event_date","accession_number","filing_url","items","text","truncated","exhibits"],"additionalProperties":false}},"source":{"type":"string","enum":["sec-edgar"]}},"required":["company","ticker","cik","count","events","source"],"additionalProperties":false}}}},"400":{"description":"Invalid input. Checked after payment verification; the payment is not settled, so nothing is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required ($0.02 USDC on Base), or the supplied payment was rejected.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 PaymentRequired object.","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Alias of PAYMENT-REQUIRED.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Payment facilitator unavailable; no payment was taken.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/scrape-markdown":{"post":{"operationId":"scrape_markdown","summary":"Read any public web page as clean Markdown: articles, docs, product and pricing pages, without navigation or clutter.","description":"Use it when an agent needs to read a web page: an article, documentation, a blog post, a product or pricing page, a news story. Fetches a public web page and returns its main content as clean Markdown, ready to put in an LLM context: scripts, styles, navigation, headers, footers and sidebars are removed, the article body is extracted (Readability), and links are made absolute. Returns the page title, the final URL after redirects and the character count; output is capped at 100,000 characters. Use it to read articles, docs, blog posts or product pages. Pages that need JavaScript to render may return little content. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.005 USDC per call via x402.","tags":["paid"],"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"x-x402":{"x402Version":2,"scheme":"exact","network":"eip155:8453","networkName":"Base","price":"$0.005","currency":"USD","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"amount":"5000","payTo":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri","description":"Public http(s) URL of the page to convert, e.g. https://example.com/article."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com"}}}},"responses":{"200":{"description":"Success. Payment of $0.005 USDC was settled.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 JSON settlement receipt (transaction hash, payer, network).","schema":{"type":"string"}},"X-PAYMENT-RESPONSE":{"description":"Alias of PAYMENT-RESPONSE.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Final URL after redirects."},"title":{"type":"string"},"markdown":{"type":"string","description":"Main content as Markdown, at most 100,000 characters."},"char_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Length of `markdown` in characters."},"truncated":{"type":"boolean","description":"True when the page or the Markdown was cut to fit the size limits."}},"required":["url","title","markdown","char_count","truncated"],"additionalProperties":false}}}},"400":{"description":"Invalid input. Checked after payment verification; the payment is not settled, so nothing is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required ($0.005 USDC on Base), or the supplied payment was rejected.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 PaymentRequired object.","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Alias of PAYMENT-REQUIRED.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Payment facilitator unavailable; no payment was taken.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/domain-enrich":{"post":{"operationId":"domain_enrich","summary":"Who runs a company's email and is it set up properly: MX, email provider, SPF, DMARC, verified SaaS and web security headers for a domain.","description":"Answers \"Who hosts this company's email, and is it configured properly?\" and \"Which SaaS tools does this company use?\". Profiles a domain from live DNS and its website: MX records and the inferred email provider (Google Workspace, Microsoft 365, …), SPF and DMARC configuration and policy, services the domain has verified ownership with (from TXT records: Google, Microsoft, Stripe, Atlassian, …), whether the website is reachable over HTTPS, and stack and security headers (Server, X-Powered-By, HSTS, CSP). Use it for lead enrichment, email deliverability checks, vendor due diligence or security reviews. You are only charged when a result is returned: invalid input (400) and upstream failures (4xx/5xx) are not settled. Costs $0.005 USDC per call via x402.","tags":["paid"],"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"x-x402":{"x402Version":2,"scheme":"exact","network":"eip155:8453","networkName":"Base","price":"$0.005","currency":"USD","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"amount":"5000","payTo":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"description":"Domain to profile, e.g. example.com. A full URL is accepted; its hostname is used.","type":"string","maxLength":300}},"required":["domain"],"additionalProperties":false},"example":{"domain":"stripe.com"}}}},"responses":{"200":{"description":"Success. Payment of $0.005 USDC was settled.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 JSON settlement receipt (transaction hash, payer, network).","schema":{"type":"string"}},"X-PAYMENT-RESPONSE":{"description":"Alias of PAYMENT-RESPONSE.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"has_mx_records":{"type":"boolean"},"mx_hosts":{"type":"array","items":{"type":"string"},"description":"Mail servers, highest priority first."},"email_provider":{"nullable":true,"description":"Inferred from MX hosts, e.g. Google Workspace or Microsoft 365.","type":"string"},"spf_configured":{"type":"boolean"},"spf_record":{"nullable":true,"type":"string"},"dmarc_configured":{"type":"boolean"},"dmarc_policy":{"nullable":true,"description":"DMARC p= value: none, quarantine or reject.","type":"string"},"verifications":{"type":"array","items":{"type":"string"},"description":"Services the domain has verified ownership with (from TXT records)."},"txt_records":{"type":"array","items":{"type":"string"},"description":"Raw TXT records (up to 25)."},"website":{"type":"object","properties":{"reachable":{"type":"boolean"},"status":{"nullable":true,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"final_url":{"nullable":true,"type":"string"},"https":{"type":"boolean"}},"required":["reachable","status","final_url","https"],"additionalProperties":false},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Selected response headers from the website: server, x-powered-by, security headers and similar."},"checked_at":{"type":"string"}},"required":["domain","has_mx_records","mx_hosts","email_provider","spf_configured","spf_record","dmarc_configured","dmarc_policy","verifications","txt_records","website","headers","checked_at"],"additionalProperties":false}}}},"400":{"description":"Invalid input. Checked after payment verification; the payment is not settled, so nothing is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required ($0.005 USDC on Base), or the supplied payment was rejected.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 PaymentRequired object.","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Alias of PAYMENT-REQUIRED.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Payment facilitator unavailable; no payment was taken.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment payload (base64 JSON). X-PAYMENT is accepted as an alias. Obtain requirements from the 402 response; see https://x402.org."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"VALIDATION_FAILED"},"message":{"type":"string"},"details":{}}}}},"PaymentRequired":{"type":"object","description":"Body mirror of the base64 PAYMENT-REQUIRED header. Clients that understand x402 v2 can ignore the body and decode the header instead.","required":["error","instructions"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["PAYMENT_REQUIRED","PAYMENT_INVALID","PAYMENT_SETTLEMENT_FAILED"]},"message":{"type":"string"},"reason":{"type":"string","description":"Facilitator/verifier reason when a payment was rejected."}}},"x402Version":{"type":"integer","example":2},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"eip155:8453"},"amount":{"type":"string","description":"Atomic token units (USDC has 6 decimals)."},"asset":{"type":"string","description":"Token contract address."},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}}}},"instructions":{"type":"string"}}}}}}