{"openapi":"3.1.0","info":{"title":"AARN","version":"0.1.0","contact":{"email":"hello@aarn.space"},"x-guidance":"AARN exposes paid agent-native web access over x402 on Base mainnet. Use POST /v1/web/read to read one public webpage as clean Markdown or plain text for 0.002 USDC. Use POST /v1/web-content/extract to extract up to 5 public webpage URLs for 0.005 USDC. These resources are useful for agent research, RAG context, analysis, and summarization. An unpaid request returns HTTP 402 with the payment requirements needed to retry the request with x402 payment proof."},"paths":{"/v1/web-content/extract":{"post":{"tags":["x402","x402","web-content-extraction"],"summary":"Extract Webpage Content to Clean Markdown","description":"Extract clean, LLM-ready Markdown or plain text from up to 5 public webpage URLs. Removes page boilerplate and returns structured per-URL results for AI agents, RAG ingestion, research and summarization.","operationId":"webpage_to_markdown","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402WebContentExtractionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The response exposes the x402 payment requirements needed to retry the request.","headers":{"payment-required":{"description":"Optional x402 payment-required challenge header.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array","description":"x402 payment options accepted by AARN.","items":{"type":"object","additionalProperties":true}},"detail":{"type":"string"}},"additionalProperties":true}}}}},"x-aarn-offering-id":"web_content_extraction:v1","x-aarn-worker-id":"web_content_extraction","x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.005000"},"protocols":[{"x402":{}}]}}},"/v1/web/read":{"post":{"tags":["x402","x402","web-read"],"summary":"Read One Webpage as Clean Markdown or Text","description":"Read one public webpage URL and return clean, LLM-ready Markdown or plain text. Designed for AI agents that need webpage contents, RAG context, research or summarization.","operationId":"web_read","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402WebReadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The response exposes the x402 payment requirements needed to retry the request.","headers":{"payment-required":{"description":"Optional x402 payment-required challenge header.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array","description":"x402 payment options accepted by AARN.","items":{"type":"object","additionalProperties":true}},"detail":{"type":"string"}},"additionalProperties":true}}}}},"x-aarn-offering-id":"web_read:v1","x-aarn-worker-id":"web_content_extraction","x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.002000"},"protocols":[{"x402":{}}]}}},"/v1/web/research":{"post":{"tags":["x402","x402","web-research"],"summary":"Bounded evidence-backed Web Research","description":"Answer one bounded research question using up to five public web sources, with structured findings linked to retrieved evidence and explicit missing information. This is bounded evidence synthesis, not exhaustive research or a truth guarantee.","operationId":"web_research","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402WebResearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402ResearchPaidResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The response exposes the x402 payment requirements needed to retry the request.","headers":{"payment-required":{"description":"Optional x402 payment-required challenge header.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array","description":"x402 payment options accepted by AARN.","items":{"type":"object","additionalProperties":true}},"detail":{"type":"string"}},"additionalProperties":true}}}}},"x-aarn-offering-id":"web_research:v1","x-aarn-worker-id":"research_synthesis","x-aarn-price-usdc":"0.50","x-aarn-default-enabled":false,"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.50"},"protocols":[{"x402":{}}]}}},"/v1/mission-control/overview":{"get":{"tags":["mission-control"],"summary":"Overview","operationId":"overview_v1_mission_control_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mission-control/jobs":{"get":{"tags":["mission-control"],"summary":"Jobs","operationId":"jobs_v1_mission_control_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mission-control/jobs/{job_id}":{"get":{"tags":["mission-control"],"summary":"Job","operationId":"job_v1_mission_control_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mission-control/economics":{"get":{"tags":["mission-control"],"summary":"Economics","operationId":"economics_v1_mission_control_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mission-control/payments":{"get":{"tags":["mission-control"],"summary":"Payments","operationId":"payments_v1_mission_control_payments_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mission-control/alerts":{"get":{"tags":["mission-control"],"summary":"Alerts","operationId":"alerts_v1_mission_control_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mission-control/marketplaces":{"get":{"tags":["mission-control"],"summary":"Marketplaces","operationId":"marketplaces_v1_mission_control_marketplaces_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mission-control/acquisition":{"get":{"tags":["mission-control"],"summary":"Acquisition","operationId":"acquisition_v1_mission_control_acquisition_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mission-control/commercial-surface":{"get":{"tags":["mission-control"],"summary":"Commercial Surface","operationId":"commercial_surface_v1_mission_control_commercial_surface_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mission-control/scout":{"get":{"tags":["mission-control"],"summary":"Scout","operationId":"scout_v1_mission_control_scout_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/marketplaces/the402/webhook":{"post":{"tags":["marketplaces","the402"],"summary":"The402 Webhook","operationId":"the402_webhook_v1_marketplaces_the402_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response The402 Webhook V1 Marketplaces The402 Webhook Post"}}}}}}},"/v1/rapidapi/web/read":{"post":{"tags":["rapidapi"],"summary":"Read one webpage as clean Markdown or text","operationId":"rapidapi_web_read","parameters":[{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapidAPIWebReadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapidAPIExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rapidapi/web-content/extract":{"post":{"tags":["rapidapi"],"summary":"Extract clean content from up to five webpages","operationId":"rapidapi_web_content_extract","parameters":[{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapidAPIWebContentExtractionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapidAPIExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rapidapi/research/synthesize":{"post":{"tags":["rapidapi"],"summary":"Research a web query and synthesize an evidence-based answer","operationId":"rapidapi_web_research_synthesize","parameters":[{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapidAPIWebResearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RapidAPIExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"RapidAPIExecutionResponse":{"properties":{"marketplace":{"type":"string","title":"Marketplace"},"provider":{"type":"string","title":"Provider"},"revenue_status":{"type":"string","title":"Revenue Status"},"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","title":"Status"},"output":{"additionalProperties":true,"type":"object","title":"Output"},"qa":{"additionalProperties":true,"type":"object","title":"Qa"},"actual_cost_eur":{"type":"string","title":"Actual Cost Eur"}},"type":"object","required":["marketplace","provider","revenue_status","job_id","status","output","qa","actual_cost_eur"],"title":"RapidAPIExecutionResponse"},"RapidAPIWebContentExtractionRequest":{"properties":{"urls":{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1,"title":"Urls"},"output_format":{"type":"string","title":"Output Format","default":"markdown"},"include_metadata":{"type":"boolean","title":"Include Metadata","default":true},"include_links":{"type":"boolean","title":"Include Links","default":false}},"type":"object","required":["urls"],"title":"RapidAPIWebContentExtractionRequest"},"RapidAPIWebReadRequest":{"properties":{"url":{"type":"string","title":"Url"},"output_format":{"type":"string","title":"Output Format","default":"markdown"},"include_metadata":{"type":"boolean","title":"Include Metadata","default":true},"include_links":{"type":"boolean","title":"Include Links","default":false}},"type":"object","required":["url"],"title":"RapidAPIWebReadRequest"},"RapidAPIWebResearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"},"instructions":{"type":"string","maxLength":2000,"minLength":1,"title":"Instructions","default":"Answer the research query with a concise, evidence-based synthesis. Use only the supplied evidence and state material uncertainty when the evidence is incomplete."},"max_sources":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Max Sources","default":5}},"type":"object","required":["query"],"title":"RapidAPIWebResearchRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"X402ResearchFinding":{"properties":{"statement":{"type":"string","minLength":1,"title":"Statement"},"source_url":{"type":"string","minLength":1,"title":"Source Url"},"evidence_excerpt":{"type":"string","minLength":1,"title":"Evidence Excerpt"}},"type":"object","required":["statement","source_url","evidence_excerpt"],"title":"X402ResearchFinding"},"X402ResearchOutput":{"properties":{"schema_version":{"type":"string","title":"Schema Version","default":"web-research-x402-v1"},"status":{"type":"string","title":"Status"},"result":{"$ref":"#/components/schemas/X402ResearchResult"},"source_urls":{"items":{"type":"string"},"type":"array","title":"Source Urls"},"model":{"type":"string","title":"Model"},"input_tokens":{"type":"integer","exclusiveMinimum":0.0,"title":"Input Tokens"},"output_tokens":{"type":"integer","exclusiveMinimum":0.0,"title":"Output Tokens"},"sources":{"items":{"$ref":"#/components/schemas/X402ResearchSource"},"type":"array","maxItems":5,"minItems":1,"title":"Sources"},"source_failures":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Failures"}},"type":"object","required":["status","result","source_urls","model","input_tokens","output_tokens","sources","source_failures"],"title":"X402ResearchOutput"},"X402ResearchPaidResponse":{"properties":{"marketplace_id":{"type":"string","title":"Marketplace Id"},"protocol":{"type":"string","title":"Protocol"},"mode":{"type":"string","title":"Mode"},"job_id":{"type":"string","title":"Job Id"},"quote":{"additionalProperties":true,"type":"object","title":"Quote"},"payment_id":{"type":"string","title":"Payment Id"},"transaction_id":{"type":"string","title":"Transaction Id"},"output":{"$ref":"#/components/schemas/X402ResearchOutput"}},"type":"object","required":["marketplace_id","protocol","mode","job_id","quote","payment_id","transaction_id","output"],"title":"X402ResearchPaidResponse"},"X402ResearchResult":{"properties":{"answer":{"type":"string","minLength":1,"title":"Answer"},"findings":{"items":{"$ref":"#/components/schemas/X402ResearchFinding"},"type":"array","minItems":1,"title":"Findings"},"missing_information":{"items":{"type":"string"},"type":"array","title":"Missing Information"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"sources_used":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Sources Used"}},"type":"object","required":["answer","findings","missing_information","limitations","sources_used"],"title":"X402ResearchResult"},"X402ResearchSource":{"properties":{"url":{"type":"string","title":"Url"},"final_url":{"type":"string","title":"Final Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"retrieved_at":{"type":"string","title":"Retrieved At"},"http_status":{"type":"integer","title":"Http Status"},"word_count":{"type":"integer","minimum":0.0,"title":"Word Count"}},"type":"object","required":["url","final_url","retrieved_at","http_status","word_count"],"title":"X402ResearchSource"},"X402WebContentExtractionRequest":{"properties":{"urls":{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1,"title":"Urls"},"output_format":{"type":"string","title":"Output Format","default":"markdown"},"include_metadata":{"type":"boolean","title":"Include Metadata","default":true},"include_links":{"type":"boolean","title":"Include Links","default":false}},"type":"object","required":["urls"],"title":"X402WebContentExtractionRequest"},"X402WebReadRequest":{"properties":{"url":{"type":"string","title":"Url"},"output_format":{"type":"string","title":"Output Format","default":"markdown"},"include_metadata":{"type":"boolean","title":"Include Metadata","default":true},"include_links":{"type":"boolean","title":"Include Links","default":false}},"type":"object","required":["url"],"title":"X402WebReadRequest"},"X402WebResearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"},"instructions":{"type":"string","maxLength":2000,"minLength":1,"title":"Instructions","default":"Answer the research question with a concise evidence-backed synthesis and state material uncertainty."},"max_sources":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Max Sources","default":5}},"additionalProperties":false,"type":"object","required":["query"],"title":"X402WebResearchRequest"}}},"externalDocs":{"description":"AARN API documentation","url":"https://api.aarn.space/docs"}}