{"uid":"cap_Pdp6bxH7tpHNrS4fqMrg_","slug":"bios-deep-research-job-starter-x402-7a6c3e82","name":"BIOS Deep Research Job Starter (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/deep-research/start","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"status":"queued","conversationId":"conv_abc123"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5XcOVNp2xnTP5m6sySSMY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Initiates a paid deep research job via the BIOS API, verifying a USDC micro-payment upfront and queuing the research task for asynchronous completion.","exampleAgentPrompt":"Start a BIOS deep research job on the latest CRISPR gene-editing breakthroughs in cancer therapy — I'll pay the 0.2 USDC fee upfront and then poll for results once it's done.","exampleUseCases":[{"title":"Biomedical literature deep dive","prompt":"Kick off a deep research job on bio.xyz asking about the current state of mRNA vaccine development for influenza — pay the 0.2 USDC fee and give me the conversation ID so I can check back for results."},{"title":"Competitive landscape research","prompt":"Start a BIOS deep research query analyzing the competitive landscape of CRISPR therapeutics companies in 2024, using my wallet to pay the micropayment fee, and return the job ID."},{"title":"Scientific hypothesis exploration","prompt":"I want to deep-research whether caloric restriction extends lifespan in primates — submit this as a BIOS research job with the crypto payment and let me know the conversation ID to poll later."}],"resultDescription":"Returns a JSON object containing a job status of 'queued' and a unique conversationId (e.g. 'conv_abc123') that can be used to poll for results via the GET endpoint once the research job completes.","failureModes":["Invalid or missing x402 PAYMENT-SIGNATURE header — payment verification fails and job is rejected","Insufficient USDC balance or malformed payment — 402 Payment Required error returned","Payment window expires before job completion — conversation enters 'timeout' status requiring a new payment","Malformed request body or missing research query — 400 Bad Request","Network or Base chain issues causing payment verification to fail","Research job fails internally — status may never transition from 'queued'"],"whenToPreferThis":"Choose this endpoint when you need to programmatically kick off a long-running, AI-powered deep research task from the BIOS platform and are able to pay via USDC on Base using the x402 protocol. It is ideal for agentic workflows where asynchronous job queuing is acceptable and crypto-native micropayments are preferred over traditional API keys or subscriptions. Prefer it over synchronous research APIs when the depth and quality of BIOS research output justifies a short wait and per-query payment model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:23.689Z","isFirstParty":false}