{"openapi":"3.1.0","info":{"title":"Tollkit Data","version":"0.19.0","description":"SEC filings and financials, IP lookup, US weather, airport delays, address geocoding, exchange rates, and x402 market data. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://chain.tollkit.dev/openapi.json.","x-guidance":"Call any operation with POST and the JSON body its schema shows. Without payment you get HTTP 402 with the exact price in USDC on Base or Solana; pay with any x402 client and repeat the request. Failed calls (any 4xx or 5xx) are never charged. Each operation's description says what it returns and which inputs are refused for free.","contact":{"email":"hello@tollkit.dev"}},"servers":[{"url":"https://data.tollkit.dev"}],"paths":{"/sec/company":{"post":{"operationId":"secCompany","summary":"SEC company profile and filings","description":"SEC company lookup: give a US stock ticker or CIK, get the company's legal name, exchange, industry, state, fiscal year end and its latest SEC filings (10-K, 10-Q, 8-K, Form 4...) with direct links, optionally filtered by form. Straight from SEC EDGAR. $0.002 per call; an unknown ticker is not charged.","tags":["Finance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"US stock ticker, e.g. AAPL. Give this or cik."},"cik":{"type":"integer","description":"SEC Central Index Key, e.g. 320193."},"form":{"type":"string","description":"Only this form type, e.g. 10-K, 10-Q, 8-K, 4."},"limit":{"type":"integer","minimum":1,"maximum":40,"default":10}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["cik","name","recent_filings","source"],"properties":{"cik":{"type":"integer"},"name":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"industry":{"type":["string","null"]},"state_of_incorporation":{"type":["string","null"]},"fiscal_year_end":{"type":["string","null"],"description":"MM-DD"},"business_address":{"type":["string","null"]},"recent_filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"filed":{"type":"string"},"report_date":{"type":["string","null"]},"accession":{"type":"string"},"url":{"type":"string"}}}},"source":{"type":"string"},"edgar_url":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/sec/financials":{"post":{"operationId":"secFinancials","summary":"Company financials from SEC filings","description":"Company financials from SEC filings: give a US stock ticker or CIK, get revenue, operating income, net income, diluted EPS, assets, liabilities, equity, cash, operating cash flow and shares outstanding for the last 4 fiscal years plus the latest quarter, exactly as filed in XBRL, each with its filing and accession number. From SEC EDGAR. $0.004 per call; a company with no financial data is not charged.","tags":["Finance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.004000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"US stock ticker. Give this or cik."},"cik":{"type":"integer","description":"SEC Central Index Key."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["cik","name","metrics","source"],"properties":{"cik":{"type":"integer"},"name":{"type":"string"},"metrics":{"type":"object","description":"Keys: revenue, operating_income, net_income, eps_diluted, total_assets, total_liabilities, stockholders_equity, cash, operating_cash_flow, shares_outstanding.","additionalProperties":{"type":["object","null"],"properties":{"concept":{"type":"string"},"unit":{"type":"string"},"annual":{"type":"array","items":{"type":"object","properties":{"period_start":{"type":["string","null"]},"period_end":{"type":"string"},"value":{"type":"number"},"form":{"type":"string"},"filed":{"type":"string"},"accession":{"type":"string"}}}},"latest_quarter":{"type":["object","null"],"properties":{"period_start":{"type":["string","null"]},"period_end":{"type":"string"},"value":{"type":"number"},"form":{"type":"string"},"filed":{"type":"string"},"accession":{"type":"string"}}}}}},"note":{"type":"string"},"source":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/ip":{"post":{"operationId":"ipLookup","summary":"IP address lookup","description":"IP geolocation: give an IPv4 or IPv6 address, get its country, region, city, continent and approximate latitude/longitude. City-level, from the DB-IP City Lite database (IP Geolocation by DB-IP, CC BY 4.0). $0.002 per lookup; private or reserved addresses are not charged.","tags":["Network"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["ip","country","attribution"],"properties":{"ip":{"type":"string"},"country":{"type":["object","null"],"properties":{"code":{"type":["string","null"]},"name":{"type":["string","null"]},"in_eu":{"type":"boolean"}}},"region":{"type":["string","null"]},"city":{"type":["string","null"]},"continent":{"type":["object","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"precision":{"type":"string"},"database":{"type":"string"},"attribution":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/weather":{"post":{"operationId":"weatherForecast","summary":"US weather forecast and alerts","description":"US weather: give a street address or a latitude and longitude, get the National Weather Service forecast for the next 7 days (day and night periods: temperature, rain chance, wind, summary) and any active weather alerts for that spot. United States only. $0.002 per call; a location outside NWS coverage is not charged.","tags":["Weather"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Give lat and lon, or a US street address.","properties":{"lat":{"type":"number","description":"Latitude, e.g. 38.98"},"lon":{"type":"number","description":"Longitude, e.g. -76.49"},"address":{"type":"string","maxLength":200,"description":"US street address instead of lat/lon, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\"."},"periods":{"type":"integer","minimum":1,"maximum":14,"default":14,"description":"How many 12-hour periods to return."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["location","forecast","alerts","source"],"properties":{"location":{"type":"object","properties":{"city":{"type":["string","null"]},"state":{"type":["string","null"]},"lat":{"type":"number"},"lon":{"type":"number"},"time_zone":{"type":["string","null"]}}},"forecast":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"temperature":{"type":"number"},"temperature_unit":{"type":"string"},"precipitation_chance":{"type":["number","null"]},"wind":{"type":"string"},"wind_direction":{"type":"string"},"summary":{"type":"string"},"detail":{"type":"string"}}}},"alerts":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string"},"severity":{"type":"string"},"headline":{"type":["string","null"]},"expires":{"type":"string"}}}},"forecast_updated":{"type":["string","null"]},"source":{"type":"string"},"geocoded":{"type":"object","description":"Present when you sent an address: what the Census geocoder matched it to.","properties":{"input":{"type":"string"},"matched_address":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"notice":{"type":"string"}}}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/fx":{"post":{"operationId":"exchangeRate","summary":"Currency exchange rate","description":"Currency conversion at European Central Bank reference rates: give two currency codes (30 supported, e.g. USD, EUR, GBP, JPY) and an amount, get the rate and converted amount for the latest business day or any day in the last 90. NOTE: these ECB reference rates are published free of charge at ecb.europa.eu; they are for information only, not for transactions. $0.002 per call; an unsupported currency is not charged.","tags":["Finance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from","to"],"properties":{"from":{"type":"string","pattern":"^[A-Za-z]{3}$"},"to":{"type":"string","pattern":"^[A-Za-z]{3}$"},"amount":{"type":"number","minimum":0,"default":1},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD within the last 90 days; weekends use the previous business day."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["from","to","rate","converted","rate_date","notice"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"amount":{"type":"number"},"rate":{"type":"number"},"converted":{"type":"number"},"rate_date":{"type":"string"},"requested_date":{"type":["string","null"]},"source":{"type":"string"},"notice":{"type":"string","description":"Required by the ECB: these rates are free at ecb.europa.eu and are for information only."}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/data/company":{"post":{"operationId":"companySnapshot","summary":"Company snapshot","description":"Company snapshot from SEC EDGAR in one call: give a US stock ticker or CIK, get the company profile, its most recent filings (10-K, 10-Q, 8-K) with links, and key financials (revenue, net income, EPS, assets, cash, cash flow) for the last two fiscal years and latest quarter. For research, due diligence and investing agents. $0.006 per call; an unknown company is not charged.","tags":["Public data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"US stock ticker, e.g. \"AAPL\". Give this or cik."},"cik":{"type":"integer","description":"SEC CIK number."},"filings":{"type":"integer","minimum":1,"maximum":40,"default":8,"description":"How many recent filings to list."},"form":{"type":"string","description":"Only this form type, e.g. \"10-K\"."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["cik","name","recent_filings","financials"],"properties":{"cik":{"type":"integer"},"name":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"industry":{"type":["string","null"]},"fiscal_year_end":{"type":["string","null"]},"recent_filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"filed":{"type":"string"},"report_date":{"type":["string","null"]},"accession":{"type":"string"},"url":{"type":"string"}}}},"financials":{"type":["object","null"],"description":"Keys: revenue, operating_income, net_income, eps_diluted, total_assets, total_liabilities, stockholders_equity, cash, operating_cash_flow, shares_outstanding. Each: unit, latest_annual, prior_annual, latest_quarter.","additionalProperties":{"type":["object","null"],"properties":{"unit":{"type":"string"},"latest_annual":{"type":"object","properties":{"period_start":{"type":["string","null"]},"period_end":{"type":"string"},"value":{"type":"number"},"form":{"type":"string"},"filed":{"type":"string"},"accession":{"type":"string"}}},"prior_annual":{"type":"object","properties":{"period_start":{"type":["string","null"]},"period_end":{"type":"string"},"value":{"type":"number"},"form":{"type":"string"},"filed":{"type":"string"},"accession":{"type":"string"}}},"latest_quarter":{"type":"object","properties":{"period_start":{"type":["string","null"]},"period_end":{"type":"string"},"value":{"type":"number"},"form":{"type":"string"},"filed":{"type":"string"},"accession":{"type":"string"}}}}}},"financials_note":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/data/diligence":{"post":{"operationId":"companyDueDiligence","summary":"Company due diligence","description":"Company due diligence in one call, from SEC EDGAR: give a US stock ticker, get the company profile, revenue and profit growth, margins, leverage and cash ratios, key financials, its key filings with links, and plain-English summaries of its latest 8-K material-event filings. For research, investing and screening agents. $0.03 per call; an unknown company is not charged.","tags":["Public data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"US stock ticker. Give this or cik."},"cik":{"type":"integer"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["cik","name","ratios","recent_material_events"],"properties":{"cik":{"type":"integer"},"name":{"type":"string"},"industry":{"type":["string","null"]},"ratios":{"type":["object","null"],"description":"revenue_growth_pct, net_income_growth_pct, operating_margin_pct, net_margin_pct, liabilities_to_assets_pct, cash_to_liabilities_pct, operating_cash_flow_to_net_income"},"financials":{"type":["object","null"]},"recent_material_events":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"filed":{"type":"string"},"url":{"type":"string"},"summary":{"type":["string","null"]}}}},"key_filings":{"type":"array"},"source":{"type":"string"},"prepared_at":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/airport/status":{"post":{"operationId":"airportDelays","summary":"US airport delays and ground stops","description":"US airport delays right now, from the FAA: give an airport code (JFK, ORD, KLAX) or nothing, get active ground stops, ground delay programs, arrival and departure delays (minutes, trend, reason) and closures, refreshed every minute. For travel and trip-planning agents. $0.003 per call; a bad code is not charged.","tags":["Travel"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"airport":{"type":"string","pattern":"^[A-Za-z0-9]{3,4}$","description":"IATA (JFK) or ICAO (KJFK). Leave out for every airport with delays."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["source"],"properties":{"airport":{"type":"string"},"status":{"type":"string","enum":["normal","delays","stopped_or_closed"]},"events":{"type":"array","items":{"type":"object","properties":{"airport":{"type":"string"},"type":{"type":"string","enum":["ground_stop","ground_delay","arrival_delay","departure_delay","closure","other"]},"reason":{"type":["string","null"]},"average_delay":{"type":["string","null"]},"min_delay":{"type":["string","null"]},"max_delay":{"type":["string","null"]},"trend":{"type":["string","null"]},"start":{"type":["string","null"]},"end":{"type":["string","null"]},"affects_airline_flights":{"type":"boolean","description":"False for closures that only keep out unscheduled or oversized aircraft."}}}},"airports_with_events":{"type":"array","items":{"type":"object","properties":{"airport":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"airport":{"type":"string"},"type":{"type":"string","enum":["ground_stop","ground_delay","arrival_delay","departure_delay","closure","other"]},"reason":{"type":["string","null"]},"average_delay":{"type":["string","null"]},"min_delay":{"type":["string","null"]},"max_delay":{"type":["string","null"]},"trend":{"type":["string","null"]},"start":{"type":["string","null"]},"end":{"type":["string","null"]},"affects_airline_flights":{"type":"boolean","description":"False for closures that only keep out unscheduled or oversized aircraft."}}}}}}},"count":{"type":"integer"},"feed_updated":{"type":["string","null"]},"note":{"type":"string"},"source":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/geocode":{"post":{"operationId":"geocodeAddress","summary":"US address to coordinates","description":"Geocode a US street address: give an address, get its latitude and longitude, the standardized address, ZIP, county (with FIPS code), state and census tract, from the US Census Bureau geocoder. $0.002 per call; an address with no match is not charged.","tags":["Maps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","maxLength":200,"description":"US street address with a house number."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["input","best","matches","notice"],"properties":{"input":{"type":"string"},"best":{"type":"object","properties":{"matched_address":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"street":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"zip":{"type":["string","null"]},"county":{"type":["string","null"]},"county_fips":{"type":["string","null"]},"state_name":{"type":["string","null"]},"census_tract":{"type":["string","null"]}}},"matches":{"type":"array","items":{"type":"object","properties":{"matched_address":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"street":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"zip":{"type":["string","null"]},"county":{"type":["string","null"]},"county_fips":{"type":["string","null"]},"state_name":{"type":["string","null"]},"census_tract":{"type":["string","null"]}}}},"match_count":{"type":"integer"},"source":{"type":"string"},"notice":{"type":"string","description":"Required by the Census Bureau's terms."}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/market/seller":{"post":{"operationId":"x402SellerLookup","summary":"x402 seller lookup","description":"x402 seller lookup: give a seller's hostname, get its rank among all x402 sellers, 30-day calls, estimated revenue and paying wallets, each endpoint's numbers and price, its categories and top competitors, plus labels where its numbers look unusual and any dated on-chain note. From the whole Coinbase Bazaar catalog, rebuilt weekly. $0.02 per call; an unknown seller is not charged.","tags":["Market data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["host"],"properties":{"host":{"type":"string","description":"Seller hostname or any URL on it."}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["host","week","rank"],"properties":{"host":{"type":"string"},"week":{"type":"string"},"rank":{"type":"integer"},"active_sellers":{"type":"integer"},"est_revenue_30d_usd":{"type":"number"},"calls_30d":{"type":"integer"},"paying_wallets_max":{"type":"integer"},"paid_endpoints":{"type":"integer"},"calls_per_wallet":{"type":["number","null"]},"patterns":{"type":"array","items":{"type":"string"}},"onchain_note":{"type":["object","null"],"properties":{"checked":{"type":"string"},"note":{"type":"string"},"source":{"type":"string"}}},"categories":{"type":"array","items":{"type":"string"}},"endpoints":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"price_usd":{"type":["number","null"]},"calls_30d":{"type":"integer"},"paying_wallets":{"type":"integer"},"calls_per_wallet":{"type":["number","null"]}}}},"endpoint_count":{"type":"integer"},"competitors":{"type":"array","items":{"type":"object","properties":{"host":{"type":"string"},"rank":{"type":"integer"},"est_revenue_usd":{"type":"number"},"paying_wallets_max":{"type":"integer"},"patterns":{"type":"array","items":{"type":"string"}}}}},"competitors_category":{"type":["string","null"]},"note":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/market/best":{"post":{"operationId":"bestX402Tools","summary":"Best x402 tools for a task","description":"Find the best paid x402 tool for a task: describe what you need (\"web search\", \"token price on solana\"), get matching endpoints ranked by paying wallets and whether buyers come back, not raw call counts, one per seller, with price and a caution where a seller's numbers look unusual. Tollkit runs this ranking and sells tools too; its own are ranked the same way and marked. $0.01 per call; a task with no match is not charged.","tags":["Market data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["task"],"properties":{"task":{"type":"string","minLength":3,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["task","week","results"],"properties":{"task":{"type":"string"},"week":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"host":{"type":"string"},"price_usd":{"type":["number","null"]},"paying_wallets_30d":{"type":"integer"},"calls_30d":{"type":"integer"},"calls_per_wallet":{"type":["number","null"]},"repeat_buyers":{"type":"boolean"},"description":{"type":"string"},"sold_by_tollkit":{"type":"boolean","description":"True for Tollkit's own tools. Tollkit runs this ranking; its tools get no boost."},"caution":{"type":["string","null"]}}}},"ranking":{"type":"string"},"disclosure":{"type":"string","description":"Tollkit runs this ranking and also sells tools."},"note":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}},"/market/dataset":{"post":{"operationId":"x402MarketDataset","summary":"x402 market dataset","description":"The whole x402 market in one JSON document: every active seller (about 2,100) with its rank, 30-day calls, estimated revenue, paying wallets, categories and unusual-number labels, plus category totals. Rebuilt weekly from Coinbase's Bazaar catalog. $0.10 per call.","tags":["Market data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","required":["week","sellers","categories"],"properties":{"week":{"type":"string"},"generated_at":{"type":"string"},"sellers":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"host":{"type":"string"},"est_revenue_usd":{"type":"number"},"calls":{"type":"integer"},"paying_wallets_max":{"type":"integer"},"patterns":{"type":"array"},"onchain_note":{"type":["object","null"]},"categories":{"type":"array"}}}},"categories":{"type":"array","items":{"type":"object"}},"note":{"type":"string"}}}}}},"400":{"description":"Bad input: a missing or malformed field, or a URL that is not public. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 quote (price, asset, network, payTo) for each network accepted. Pay and retry with PAYMENT-SIGNATURE."},"422":{"description":"Valid input the tool could not answer, e.g. an empty page, a token with no pool, an unknown ticker. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"429":{"description":"Too many requests from this caller; retry after a short wait. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"502":{"description":"An upstream source (the page, a chain RPC, a public data API) failed or timed out. Not charged; safe to retry.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}},"503":{"description":"The tool is temporarily unavailable on this deployment. Not charged.","content":{"application/json":{"schema":{"type":"object","required":["error","message","charged"],"properties":{"error":{"type":"string","description":"Machine-readable code, e.g. invalid_url, no_pool, page_fetch_failed."},"message":{"type":"string","description":"Plain-English reason, ending in \"Nothing was charged.\""},"charged":{"type":"boolean","const":false}}}}}}}}}}}