{"openapi":"3.1.0","info":{"title":"Lumen Works Agent API (Lumen Pre-Sign Check + Lumen Agent Utilities)","version":"1.4.0","description":"x402-paid agent tools. Author Dan (Dansgit2b). Informational, not a security guarantee; looks_ok does not mean safe; no simulation.","contact":{"name":"Dan (Dansgit2b)","url":"https://github.com/Dansgit2b/lumenworks-x402-api"}},"servers":[{"url":"https://lumenworks-x402-decoder.onrender.com"}],"paths":{"/v1/x402/lint":{"post":{"operationId":"_v1_x402_lint","summary":"Decode and lint an x402 PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE header (base64 or JSON): kind, decoded object, errors/warnings (CAIP-2, checksum, EIP-712 domain, expiry).","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"header":{"type":"string","description":"base64 x402 header value"},"json":{"type":"object"}}},"example":{"header":"eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9sdW1lbndvcmtzLXg0MDItZGVjb2Rlci5vbnJlbmRlci5jb20vdjEvdHgvZXhwbGFpbiJ9LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MyIsImFtb3VudCI6IjIwMDAiLCJhc3NldCI6IjB4ODMzNTg5ZkNENmVEYjZFMDhmNGM3QzMyRDRmNzFiNTRiZEEwMjkxMyIsInBheVRvIjoiMHhlZTk3OTBjQjM5NjA5NTJGNTg1Mzc5RjgzMWE4OWI0ZTAwQjQwMjlBIiwibWF4VGltZW91dFNlY29uZHMiOjEyMCwiZXh0cmEiOnsibmFtZSI6IlVTRCBDb2luIiwidmVyc2lvbiI6IjIifX1dfQ=="}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"ok":true,"kind":"PAYMENT-REQUIRED","decoded":{"x402Version":2,"resource":{"url":"https://lumenworks-x402-decoder.onrender.com/v1/tx/explain"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"2000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A","maxTimeoutSeconds":120,"extra":{"name":"USD Coin","version":"2"}}]},"issues":[]}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/eip712/decode":{"post":{"operationId":"_v1_eip712_decode","summary":"Decode EIP-712 typed data: domain separator, signing digest, message, and plain-language risk notes (Permit, Permit2, EIP-3009, unlimited values).","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"typedData":{"type":"object"}},"required":["typedData"]},"example":{"typedData":{"domain":{"name":"USD Coin","version":"2","chainId":8453,"verifyingContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"primaryType":"Permit","types":{"EIP712Domain":[{"name":"name","type":"string"},{"name":"version","type":"string"},{"name":"chainId","type":"uint256"},{"name":"verifyingContract","type":"address"}],"Permit":[{"name":"owner","type":"address"},{"name":"spender","type":"address"},{"name":"value","type":"uint256"},{"name":"nonce","type":"uint256"},{"name":"deadline","type":"uint256"}]},"message":{"owner":"0x1111111111111111111111111111111111111111","spender":"0x111111125421cA6dc452d289314280a0f8842A65","value":"1000000","nonce":"0","deadline":"1893456000"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"primaryType":"Permit","domain":{"name":"USD Coin","version":"2","chainId":8453,"verifyingContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"domainSeparator":"0x02fa7265e7c5d81118673727957699e4d68f74cd74b7db77da710fe8a2c7834f","digest":"0x23e8c55a0b5d344e0f50581dd1210e0656d001958874ac7ac06c60f1c4ad9704","message":{"owner":"0x1111111111111111111111111111111111111111","spender":"0x111111125421cA6dc452d289314280a0f8842A65","value":"1000000","nonce":"0","deadline":"1893456000"},"notes":["verifyingContract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on chainId 8453","ERC-2612 Permit: grants token allowance to spender, check value/deadline"]}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/calldata/decode":{"post":{"operationId":"_v1_calldata_decode","summary":"Use when you hold raw EVM calldata and need to know what function it calls: returns selector, matching signatures (built-in + openchain/4byte) and ABI-decoded args for each candidate; unknown selectors return signaturesFound:0 instead of an error. Optional {signature} override. Example: 0xa9059cbb… -> transfer(address,uint256) with args. $0.002, no signup; not charged if the call errors.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"string","description":"Calldata hex starting with the 4-byte selector (0x…)"},"signature":{"type":"string","description":"Optional function signature override, e.g. transfer(address,uint256)"}},"required":["data"]},"example":{"data":"0xa9059cbb000000000000000000000000ee9790cb3960952f585379f831a89b4e00b4029a00000000000000000000000000000000000000000000000000000000000f4240"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"selector":"0xa9059cbb","signaturesFound":1,"decoded":{"signature":"transfer(address,uint256)","args":["0xee9790cB3960952F585379F831a89b4e00B4029A","1000000"]},"candidates":[{"signature":"transfer(address,uint256)","args":["0xee9790cB3960952F585379F831a89b4e00B4029A","1000000"]}],"source":"openchain/4byte"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/web/markdown":{"post":{"operationId":"_v1_web_markdown","summary":"Use when you need to read a public web page as clean LLM-ready Markdown: Readability main-content extraction (nav/scripts stripped) plus title, byline, excerpt, OpenGraph metadata. {fullPage:true} keeps the whole body; {maxChars} caps output (default 100k). No JavaScript rendering, no PDFs. Example: {url:\"https://example.com\"} -> {title:\"Example Domain\", markdown:\"# Example Domain …\"}. $0.001, no signup; not charged if the fetch fails.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public http(s) URL"},"fullPage":{"type":"boolean","description":"Keep the whole body instead of Readability main content"},"maxChars":{"type":"number","description":"Max Markdown characters (default 100000)"}},"required":["url"]},"example":{"url":"https://example.com","maxChars":2000}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"url":"https://example.com/","status":200,"title":"Example Domain","excerpt":"This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.","metadata":{"title":"Example Domain","favicon":"data:,","lang":"en"},"wordCount":25,"truncated":false,"markdown":"This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes."}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/web/unfurl":{"post":{"operationId":"_v1_web_unfurl","summary":"Unfurl a URL: final URL after redirects, HTTP status, title, description, OpenGraph/Twitter image, site name, canonical, favicon, language, published time.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"example":{"url":"https://github.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"url":"https://github.com/","status":200,"contentType":"text/html; charset=utf-8","title":"GitHub · Change is constant. GitHub keeps you ahead. · GitHub","description":"Join the world's most widely adopted, AI-powered developer platform where millions of developers, businesses, and the largest open source community build software that advances humanity.","image":"https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png","siteName":"GitHub","type":"object","canonical":"https://github.com/","favicon":"https://github.githubassets.com/favicons/favicon.png","lang":"en","twitterCard":"summary_large_image","linkCount":140}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/evm/address":{"post":{"operationId":"_v1_evm_address","summary":"Look up an EVM address or ENS name on Ethereum + Base: ENS forward/reverse + text records, EOA vs contract (EIP-7702 delegation flag), native balance, tx count, USDC/USDT balances, and ERC-20 name/symbol/decimals/supply if it is a token.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"0x address or ENS name"}},"required":["address"]},"example":{"address":"vitalik.eth"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","ens":"vitalik.eth","ensRecords":{"avatar":"https://euc.li/vitalik.eth","url":"https://vitalik.ca","com.twitter":"VitalikButerin","com.github":"vbuterin","description":"mi pinxe lo crino tcati"},"chains":{"ethereum":{"isContract":true,"nativeBalance":"5.768184715803065014","txCount":5969,"stablecoins":{"USDC":"37.192124","USDT":"291.368219"},"codeSize":23,"eip7702Delegated":true},"base":{"isContract":true,"nativeBalance":"3.12882180347263728","txCount":70,"stablecoins":{"USDC":"44.783666"},"codeSize":23,"eip7702Delegated":true}},"source":"public RPC (publicnode.com)","at":"2026-10-10T12:48:30.232Z"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/domain/lookup":{"post":{"operationId":"_v1_domain_lookup","summary":"Domain intelligence: DNS A/AAAA/CNAME/MX/NS/TXT/CAA (DNS-over-HTTPS), SPF + DMARC, RDAP registration/expiry/registrar/status, domain age in days. Useful for phishing/fraud checks and lead qualification.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"example":{"domain":"example.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"domain":"example.com","resolves":true,"dns":{"A":["172.66.147.243","104.20.23.154"],"AAAA":["2606:4700:10::6814:179a","2606:4700:10::ac42:93f3"],"CNAME":[],"MX":[{"priority":0,"exchange":""}],"NS":["hera.ns.cloudflare.com","elliott.ns.cloudflare.com"],"TXT":["v=spf1 -all","_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9"],"CAA":[]},"email":{"hasMx":true,"spf":"v=spf1 -all","dmarc":"v=DMARC1;p=reject;sp=reject;adkim=s;aspf=s"},"rdap":{"handle":"2336799_DOMAIN_COM-VRSN","status":["client delete prohibited","client transfer prohibited","client update prohibited"],"registered":"1995-08-14T04:00:00Z","expires":"2027-08-13T04:00:00Z","lastChanged":"2026-08-14T08:01:43Z","registrar":"RESERVED-Internet Assigned Numbers Authority","nameservers":["elliott.ns.cloudflare.com","hera.ns.cloudflare.com"],"dnssec":true},"ageDays":11380,"at":"2026-10-10T12:48:30.425Z"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/tx/explain":{"post":{"operationId":"_v1_tx_explain","summary":"Lumen Pre-Sign Check. Use before signing any EVM transaction or EIP-712 message: returns {summary, flags[], verdict} with verdict looks_ok | review | do_not_sign_unless_intended. Flags unlimited approve/increaseAllowance, EIP-2612 Permit and Permit2 (typed data and on-chain), setApprovalForAll, unknown spender, admin calls (upgradeTo/transferOwnership), zero-price Seaport orders, long deadlines, chain mismatch and x402 payTo mismatch; decodes multicall/aggregate3 inner calls one level. Example: USDC approve(spender, 2^256-1) -> do_not_sign_unless_intended, UNLIMITED_APPROVAL. Agent policy: abort on do_not_sign_unless_intended, escalate review. Informational, not a security guarantee; looks_ok does not mean safe; no simulation. $0.002, no signup, free tier 20/h; not charged if the call errors.","tags":["Lumen Pre-Sign Check"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transaction":{"type":"object","description":"Unsigned EVM transaction","properties":{"to":{"type":"string","description":"Target contract/address (0x…)"},"data":{"type":"string","description":"Calldata hex (0x…)"},"value":{"type":"string","description":"Native value in wei (decimal string)"}},"required":["data"]},"calldata":{"type":"string","description":"Shortcut: calldata hex when you have no tx object"},"typedData":{"type":"object","description":"EIP-712 typed data {domain, types, primaryType, message} (Permit, Permit2, EIP-3009, Seaport…)"},"chainId":{"type":"number","description":"Chain the wallet is on; used for chain-mismatch checks"},"expected_pay_to":{"type":"string","description":"For x402/EIP-3009 payments: the payTo you expect; mismatch is flagged"}},"anyOf":[{"required":["transaction"]},{"required":["calldata"]},{"required":["typedData"]}]},"example":{"transaction":{"to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","data":"0x095ea7b3000000000000000000000000111111125421ca6dc452d289314280a0f8842a65ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff","value":"0"},"chainId":8453}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"kind":"transaction","summary":["Approve 0x111111125421cA6dc452d289314280a0f8842A65 (1inch v6 Router) to spend UNLIMITED units of token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"flags":[{"level":"high","code":"UNLIMITED_APPROVAL","msg":"Unlimited token approval: spender can drain this token at any time."}],"calldata":{"selector":"0x095ea7b3","signaturesFound":1,"decoded":{"signature":"approve(address,uint256)","args":["0x111111125421cA6dc452d289314280a0f8842A65","115792089237316195423570985008687907853269984665640564039457584007913129639935"]},"candidates":[{"signature":"approve(address,uint256)","args":["0x111111125421cA6dc452d289314280a0f8842A65","115792089237316195423570985008687907853269984665640564039457584007913129639935"]}],"source":"built-in"},"to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","toLabel":"USDC (Base)","valueWei":"0","risk":"high","verdict":"do_not_sign_unless_intended","disclaimer":"Informational, not a security guarantee. looks_ok does not mean safe. No simulation, no on-chain state (proxy implementations, spender code, balances) is checked."}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/pubmed/search":{"post":{"operationId":"_v1_pubmed_search","summary":"Search PubMed (36M+ biomedical citations): PMID, title, journal, date, authors, DOI, URL and abstract. {query, limit<=50, sort:relevance|date, abstracts:true}.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"sort":{"type":"string","enum":["relevance","date"]},"abstracts":{"type":"boolean"}},"required":["query"]},"example":{"query":"GLP-1 obesity","limit":2}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"query":"GLP-1 obesity","total":11811,"results":[{"pmid":"40466247","title":"GLP-1-based medications: Mechanisms involved in obesity treatment.","journal":"Medicina clinica","pubDate":"2025 Jul","authors":["Salvador J"],"doi":"10.1016/j.medcli.2025.107035","url":"https://pubmed.ncbi.nlm.nih.gov/40466247/","abstract":"Thanks to biochemical engineering, the glucagon-like peptide-1 (GLP-1) molecule has emerged as an essential element in the development of diverse agonists and multiagonists, based in the GLP-1 structure for obesity treatment. These new antiobesity medications can reach up to 24% weight loss, which makes possible an effective management of obesity and its complications. GLP-1 agonists affect divers…"},{"pmid":"34626851","title":"GLP-1 physiology informs the pharmacotherapy of obesity.","journal":"Molecular metabolism","pubDate":"2022 Mar","authors":["Drucker DJ"],"doi":"10.1016/j.molmet.2021.101351","url":"https://pubmed.ncbi.nlm.nih.gov/34626851/","abstract":"Glucagon-like peptide-1 receptor agonists (GLP1RA) augment glucose-dependent insulin release and reduce glucagon secretion and gastric emptying, enabling their successful development for the treatment of type 2 diabetes (T2D). These agents also inhibit food intake and reduce body weight, fostering investigation of GLP1RA for the treatment of obesity. Here I discuss the physiology of Glucagon-like …"}],"source":"NCBI PubMed E-utilities"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/arxiv/search":{"post":{"operationId":"_v1_arxiv_search","summary":"Search arXiv preprints: id, title, abstract, authors, categories, dates, PDF link. Supports arXiv field prefixes (ti:, au:, cat:). {query, limit<=50, sort:relevance|date}.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"sort":{"type":"string","enum":["relevance","date"]}},"required":["query"]},"example":{"query":"LLM agents tool use","limit":2}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"query":"LLM agents tool use","total":1585251,"results":[{"id":"2111.01762v1","title":"AIRCC-Clim: a user-friendly tool for generating regional probabilistic climate change scenarios and risk measures","summary":"Complex physical models are the most advanced tools available for producing realistic simulations of the climate system. However, such levels of realism imply high computational cost and restrictions on their use for policymaking and risk assessment. Two central characteristics of climate change are uncertainty and that it is a dynamic problem in which international actions can significantly alter…","authors":["Francisco Estrada","Oscar Calderón-Bustamante","Wouter Botzen"],"published":"2021-10-30T11:09:03Z","updated":"2021-10-30T11:09:03Z","categories":["physics.ao-ph","econ.GN","stat.AP"],"pdf":"https://arxiv.org/pdf/2111.01762v1","url":"http://arxiv.org/abs/2111.01762v1"},{"id":"2605.18805v1","title":"RecoAtlas: From Semantic Plausibility to Set-Level Utility in LLM Recommendation Agents","summary":"LLM recommendation agents increasingly produce structured recommendation reports: sets of items accompanied by natural-language justifications. Yet existing evaluations often reduce this setting to reranking small shortlisted candidate sets or judge reports mainly by semantic plausibility. We introduce Recommendation Atlas (Agentic Tool-Level Assessment for Shopping), or RecoAtlas, a benchmark and…","authors":["Imad Aouali","Flavian Vasile","Otmane Sakhi"],"published":"2026-05-11T18:55:32Z","updated":"2026-05-11T18:55:32Z","categories":["cs.IR","cs.AI","cs.LG"],"pdf":"https://arxiv.org/pdf/2605.18805v1","url":"http://arxiv.org/abs/2605.18805v1"}],"source":"arXiv API"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/sec/filings":{"post":{"operationId":"_v1_sec_filings","summary":"SEC EDGAR company lookup by ticker or CIK: company profile, recent filings (filter by form e.g. 10-K, 10-Q, 8-K, 4) with document links, and latest annual XBRL facts (revenue, net income, assets, liabilities, equity, EPS, cash).","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"cik":{"type":"string"},"forms":{"type":"array","items":{"type":"string"}},"limit":{"type":"number"},"facts":{"type":"boolean"}}},"example":{"ticker":"AAPL","forms":["10-K"],"limit":2}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"cik":"0000320193","name":"Apple Inc.","ticker":"AAPL","sic":"3571","sicDescription":"Electronic Computers","stateOfIncorporation":"CA","fiscalYearEnd":"0926","filings":[{"form":"10-K","filed":"2025-10-31","reportDate":"2025-09-27","description":"10-K","url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"},{"form":"10-K","filed":"2024-11-01","reportDate":"2024-09-28","description":"10-K","url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}],"latestAnnualFacts":{"Revenues":{"value":62900000000,"period":"2018-09-29","form":"10-K","fy":2018},"RevenueFromContractWithCustomerExcludingAssessedTax":{"value":416161000000,"period":"2025-09-27","form":"10-K","fy":2025},"NetIncomeLoss":{"value":112010000000,"period":"2025-09-27","form":"10-K","fy":2025},"Assets":{"value":359241000000,"period":"2025-09-27","form":"10-K","fy":2025},"Liabilities":{"value":285508000000,"period":"2025-09-27","form":"10-K","fy":2025},"StockholdersEquity":{"value":73733000000,"period":"2025-09-27","form":"10-K","fy":2025},"EarningsPerShareDiluted":{"value":7.46,"period":"2025-09-27","form":"10-K","fy":2025},"CashAndCashEquivalentsAtCarryingValue":{"value":35934000000,"period":"2025-09-27","form":"10-K","fy":2025}},"source":"SEC EDGAR (data.sec.gov)"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/weather/forecast":{"post":{"operationId":"_v1_weather_forecast","summary":"Weather for any place name or lat/lon (Open-Meteo): current conditions plus up to 16-day daily forecast (temp min/max, precipitation and probability, wind, UV, sunrise/sunset). {location | latitude+longitude, days, units:metric|imperial}.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string","description":"Place name, e.g. Berlin (geocoded)"},"latitude":{"type":"number","description":"Latitude (use with longitude instead of location)"},"longitude":{"type":"number","description":"Longitude"},"days":{"type":"number","description":"Forecast days, 1-16 (default 7)"},"units":{"type":"string","enum":["metric","imperial"],"description":"Default metric"}},"anyOf":[{"required":["location"]},{"required":["latitude","longitude"]}]},"example":{"location":"Berlin","days":2}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"place":{"name":"Berlin","country":"Germany","admin1":"State of Berlin","timezone":"Europe/Berlin","geocoder":"open-meteo"},"latitude":52.512604,"longitude":13.419517,"timezone":"Europe/Berlin","units":{"time":"iso8601","interval":"seconds","temperature_2m":"°C","apparent_temperature":"°C","relative_humidity_2m":"%","precipitation":"mm","weather_code":"wmo code","wind_speed_10m":"km/h","wind_direction_10m":"°","is_day":""},"current":{"time":"2026-10-10T14:45","interval":900,"temperature_2m":16.5,"apparent_temperature":13.4,"relative_humidity_2m":51,"precipitation":0,"weather_code":2,"wind_speed_10m":14.8,"wind_direction_10m":257,"is_day":1},"daily":[{"date":"2026-10-10","weatherCode":80,"tMax":16.7,"tMin":11.1,"precipSum":1.5,"precipProbMax":85,"windMax":17.4,"uvMax":3.1,"sunrise":"2026-10-10T07:22","sunset":"2026-10-10T18:23"},{"date":"2026-10-11","weatherCode":80,"tMax":12.7,"tMin":8.4,"precipSum":0.9,"precipProbMax":83,"windMax":16.8,"uvMax":1.65,"sunrise":"2026-10-11T07:24","sunset":"2026-10-11T18:20"}],"source":"Open-Meteo (CC BY 4.0)"}}}},"402":{"description":"Payment Required (x402 v2)"}}}},"/v1/polymarket/markets":{"post":{"operationId":"_v1_polymarket_markets","summary":"Read-only Polymarket prediction-market data: search by {query} or top active markets by 24h volume. Returns question, outcomes with implied probabilities, 24h/total volume, liquidity, end date, URL. Data only, no trading.","tags":["Lumen Agent Utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xee9790cB3960952F585379F831a89b4e00B4029A"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"}}},"example":{"limit":2}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"query":null,"markets":[{"question":"Dota 2: Team Yandex vs Team Spirit - Game 2 Winner","slug":"dota2-ty-ts8-2026-10-10-game2","endDate":"2026-10-10T14:30:00Z","outcomes":[{"outcome":"Team Yandex","probability":0.987},{"outcome":"Team Spirit","probability":0.013}],"volume24h":1246835.9942849993,"volumeTotal":1242546.0467380008,"liquidity":94999.5371,"active":true,"closed":false,"url":"https://polymarket.com/market/dota2-ty-ts8-2026-10-10-game2"},{"question":"Will Luiz Inácio Lula da Silva win the 2026 Brazilian presidential election?","slug":"will-luiz-incio-lula-da-silva-win-the-2026-brazilian-presidential-election","endDate":"2026-10-05T03:59:00Z","outcomes":[{"outcome":"Yes","probability":0.115},{"outcome":"No","probability":0.885}],"volume24h":894261.5656739997,"volumeTotal":21990309.847675,"liquidity":1469356.5492,"active":true,"closed":false,"url":"https://polymarket.com/market/will-luiz-incio-lula-da-silva-win-the-2026-brazilian-presidential-election"}],"note":"Top active markets by 24h volume. Read-only data; not financial advice.","source":"Polymarket Gamma API"}}}},"402":{"description":"Payment Required (x402 v2)"}}}}}}