{"uid":"cap_gLDnW3nHVFhFN0wwqcqA0","slug":"bios-literature-query-api-x402-bbca365c","name":"BIOS Literature Query API (x402)","description":"Payment proxy for the BIOS Deep Research API, powered by the x402 protocol.\n\nThis service wraps the BIOS deep-research endpoints with crypto micro-payments using USDC on Base. Payments are verified upfront but only settled once the research job completes.\n\n## How it works\n\n1. **Start a research job** — `POST /api/deep-research/start` with an x402 `PAYMENT-SIGNATURE` header. The payment is verified but not settled yet.\n2. **Poll for results** — `GET /api/deep-research/{conversationId}` with an `X-SIWX` header (SIWE wallet signature). Only the wallet that paid can access results.\n3. **On-demand settlement** — When polling a completed job, the payment is settled immediately and results returned. A background cron also handles batch settlement.\n4. **Timeout handling** — If the payment window expires before completion, the conversation enters `timeout` status. A new payment is required to retrieve results.\n\n## SIWX Authentication (Sign-In With X)\n\nThe `GET /api/deep-research/{conversationId}` endpoint requires wallet-based authentication via EIP-4361 (SIWE). When called without a valid `X-SIWX` header, the endpoint returns `401` with a SIWE challenge. The client must sign this challenge with the same wallet that made the original payment and resend the request.\n\nThe `X-SIWX` header is a base64-encoded JSON object: `{ \"message\": \"<EIP-4361 message>\", \"signature\": \"0x...\" }`.\n\n## x402 Payment Protocol\n\nAll paid endpoints return `402 Payment Required` with a `PAYMENT-REQUIRED` header when no payment is provided. The header contains the payment requirements (price, token, network) that clients use to construct a payment.\n\nSee [x402 docs](https://docs.cdp.coinbase.com/x402/core-concepts/how-it-works) for details.","url":"https://x402.ai.bio.xyz/api/agents/literature/query","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"answer":"Recent studies show...","references":[{"url":"...","title":"..."}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_se3Do48e4s5cU760XkGjs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries the BIOS deep-research literature endpoint to retrieve AI-synthesized answers and cited references from scientific literature, paid via USDC micro-payment on Base.","exampleAgentPrompt":"Search the BIOS deep research literature database for what recent studies say about the role of gut microbiome in Parkinson's disease, and give me a synthesized answer with cited references.","exampleUseCases":[{"title":"Biomedical evidence synthesis for clinicians","prompt":"What does recent scientific literature say about the efficacy of GLP-1 receptor agonists for non-alcoholic fatty liver disease? Give me a summary with cited sources."},{"title":"Drug mechanism literature review","prompt":"Look up peer-reviewed research on the mechanism of action of CRISPR-Cas9 off-target effects in gene therapy and summarize the key findings with references."},{"title":"Competitive landscape research for biotech","prompt":"Find recent studies on CAR-T cell therapy for solid tumors — what progress has been made in the last few years and what are the main challenges still being studied?"}],"resultDescription":"Returns a JSON object with a synthesized natural-language answer to the research question and an array of references, each containing a URL and title of the supporting scientific paper or source.","failureModes":["Missing or invalid x402 PAYMENT-SIGNATURE header returns a 402 Payment Required error","Payment window expiration causes conversation to enter timeout status, requiring a new payment to retrieve results","Invalid or expired SIWX wallet signature on GET polling endpoint returns 401 Unauthorized","Research job not yet completed returns a pending/in-progress status on polling","Network or provider-side timeout for long-running deep research jobs","Malformed query body returns 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when you need AI-synthesized answers grounded in real scientific literature with citations, specifically within the biomedical and life sciences domain. It is ideal over general-purpose web search when verifiability of sources matters, or when the query requires synthesis across multiple peer-reviewed papers. Prefer it over general LLM knowledge when you need up-to-date or niche scientific references. It suits agentic workflows that can handle async polling and crypto micro-payments via the x402 protocol on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:48.309Z","isFirstParty":false}