{"openapi":"3.1.0","info":{"title":"NythosX Agent Tools API","version":"1","description":"Pay-per-call tools for AI agents via x402: current gas and fee prices across six chains, and web page to Markdown conversion. Informational data. Verify critical values before acting.","x-guidance":"Gas/fee prices and URL→Markdown for agents, paid per call in USDC via x402. Start with GET /v1/gas?chain=base for current fees, or GET /v1/read?url= for clean Markdown. Free samples: /v1/sample?endpoint={gas|compare|read}. Free chain list: /v1/chains. Every response is an envelope. Failed calls are not charged.","contact":{"url":"https://tools.nythosx.com","email":"support@nythosx.com"}},"servers":[{"url":"https://tools.nythosx.com"}],"paths":{"/v1/gas":{"get":{"operationId":"gas","summary":"Current gas and fee prices for one chain","description":"Current gas and fee prices for Base, Ethereum, Arbitrum, Optimism, Polygon or Solana: slow/standard/fast tiers and the USD cost of a transfer, USDC transfer and swap. Updated every 15 seconds. Price: $0.002 USDC per call via x402.","tags":["Agent tools"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"endpoint":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source_timestamp":{"type":["string","null"],"format":"date-time"},"data":{"type":"object"},"disclaimer":{"type":"string"}},"required":["schema_version","endpoint","generated_at","data","disclaimer"]},"example":{"schema_version":"1","data":{"chain":"base","name":"Base","block":21512345,"blockTime":"2026-10-21T00:00:00.000Z","nativeSymbol":"ETH","nativeUsd":2468.07,"baseFeeGwei":0.0052,"tiers":{"slow":{"maxPriorityFeeGwei":0.001,"maxFeeGwei":0.0114},"standard":{"maxPriorityFeeGwei":0.002,"maxFeeGwei":0.0124},"fast":{"maxPriorityFeeGwei":0.01,"maxFeeGwei":0.0204}},"costUsd":{"transfer":{"slow":0.0004,"standard":0.0005,"fast":0.0008},"usdc_transfer":{"slow":0.0011,"standard":0.0012,"fast":0.0019},"swap":{"slow":0.0031,"standard":0.0035,"fast":0.0052}},"l1DataFeeIncluded":true,"gasUnits":{"transfer":21000,"usdc_transfer":65000,"swap":180000},"rpc":"mainnet.base.org"}}}}},"400":{"description":"Invalid input. Not charged."},"402":{"description":"Payment required."},"502":{"description":"Upstream unavailable. Not charged."},"503":{"description":"Facilitator unavailable. Retry later."}},"parameters":[{"name":"chain","in":"query","required":true,"description":"Chain to query","schema":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","solana"]}}]}},"/v1/gas/compare":{"get":{"operationId":"compare","summary":"Where is it cheapest to send this transaction right now?","description":"Ranks all supported chains by the USD cost of a specific transaction type (transfer, USDC transfer or swap) at a specific speed tier (slow, standard or fast). Returns the sorted ranking, the cheapest chain and any chains that could not be queried. Price: $0.005 USDC per call via x402.","tags":["Agent tools"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"endpoint":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source_timestamp":{"type":["string","null"],"format":"date-time"},"data":{"type":"object"},"disclaimer":{"type":"string"}},"required":["schema_version","endpoint","generated_at","data","disclaimer"]},"example":{"schema_version":"1","data":{"tx":"usdc_transfer","tier":"standard","ranking":[{"chain":"solana","name":"Solana","costUsd":0.0011,"block":245123456,"l1DataFeeIncluded":false},{"chain":"base","name":"Base","costUsd":0.0012,"block":21512345,"l1DataFeeIncluded":true}],"cheapest":"solana","failed":[{"chain":"polygon","name":"Polygon PoS"}]}}}}},"400":{"description":"Invalid input. Not charged."},"402":{"description":"Payment required."},"502":{"description":"Upstream unavailable. Not charged."},"503":{"description":"Facilitator unavailable. Retry later."}},"parameters":[{"name":"tx","in":"query","required":false,"description":"Transaction type","schema":{"type":"string","enum":["transfer","usdc_transfer","swap"],"default":"transfer"}},{"name":"tier","in":"query","required":false,"description":"Speed tier","schema":{"type":"string","enum":["slow","standard","fast"],"default":"standard"}}]}},"/v1/read":{"get":{"operationId":"read","summary":"Convert any web page into clean, readable Markdown","description":"Fetches a public web page and returns clean Markdown: title, byline, site name, excerpt, word count and the extracted article body. Use it to give an AI agent readable text from a URL without writing your own scraper. Respects robots.txt, blocks private hosts, follows at most five redirects, caps the page at 3 MB. Pass links=true to also get the page's outbound links. Price: $0.003 USDC per call via x402.","tags":["Agent tools"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"endpoint":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source_timestamp":{"type":["string","null"],"format":"date-time"},"data":{"type":"object"},"disclaimer":{"type":"string"}},"required":["schema_version","endpoint","generated_at","data","disclaimer"]},"example":{"schema_version":"1","data":{"url":"https://example.com","finalUrl":"https://example.com/","status":200,"title":"Example Domain","byline":null,"siteName":null,"lang":"en","publishedTime":null,"excerpt":"This domain is for use in illustrative examples in documents.","wordCount":42,"markdown":"# Example Domain\n\nThis domain is for use in illustrative examples..."}}}}},"400":{"description":"Invalid input. Not charged."},"402":{"description":"Payment required."},"502":{"description":"Upstream unavailable. Not charged."},"503":{"description":"Facilitator unavailable. Retry later."}},"parameters":[{"name":"url","in":"query","required":true,"description":"Public http(s) URL to read","schema":{"type":"string"}},{"name":"links","in":"query","required":false,"description":"Set to true to include the page's outbound links (max 200)","schema":{"type":"string","enum":["true","false"],"default":"false"}}]}},"/v1/chains":{"get":{"operationId":"chains","summary":"Supported chains (free)","security":[],"responses":{"200":{"description":"Chains"}}}},"/v1/sample":{"get":{"operationId":"sample","summary":"Free sample response for a paid endpoint","security":[],"parameters":[{"name":"endpoint","in":"query","required":true,"schema":{"type":"string","enum":["gas","compare","read"]}}],"responses":{"200":{"description":"Sample"}}}},"/api/catalog":{"get":{"operationId":"catalog","summary":"Machine-readable catalog (free)","security":[],"responses":{"200":{"description":"Catalog"}}}}}}