← oblique.markets · all endpoints

POST /api/v1/paid/research-answer — $0.01 per call

Use when an agent needs a concise, cited answer to one research question with optional domain scope and freshness, from one bounded pay-per-call web search. Returns the answer synthesized only from the retrieved sources, source URLs and labels with retrieval timestamps, an explicit insufficient-evidence refusal when the sources do not support an answer, and a machine-readable receipt of the upstream cost and settlement.

Try it

curl -i https://api.oblique.markets/api/v1/paid/research-answer
# → HTTP 402 with the exact payment requirements; pay, then retry with PAYMENT-SIGNATURE (x402) or Authorization: Payment (MPP)

Input schema

{
 "type": "object",
 "required": [
  "question"
 ],
 "properties": {
  "question": {
   "type": "string",
   "minLength": 1,
   "maxLength": 500,
   "description": "One concise research question"
  },
  "scope": {
   "type": "object",
   "properties": {
    "include_domains": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "maxItems": 5,
     "description": "Only search these domains"
    },
    "exclude_domains": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "maxItems": 5,
     "description": "Never use these domains"
    }
   },
   "additionalProperties": false
  },
  "freshness": {
   "type": "string",
   "enum": [
    "day",
    "week",
    "month",
    "year"
   ],
   "description": "Only sources from the last day/week/month/year"
  },
  "max_sources": {
   "type": "integer",
   "minimum": 1,
   "maximum": 5,
   "default": 5
  }
 },
 "additionalProperties": false
}

Example output

{
 "question": "What is the x402 payment protocol and who maintains it?",
 "scope": {
  "include_domains": [],
  "exclude_domains": [],
  "freshness": "year"
 },
 "status": "answered",
 "answer": "x402 is an open HTTP payment protocol that revives the 402 status code so software agents pay per request in stablecoins without API keys; it was published by Coinbase in 2025 and is developed as an open-source standard with a public facilitator on Base [1][2].",
 "cited": [
  1,
  2
 ],
 "uncertainty": "Source 2 is a vendor page; governance beyond Coinbase is not described in these sources.",
 "reason": null,
 "sources": [
  {
   "id": 1,
   "label": "x402 — Payment Required",
   "url": "https://x402.org/",
   "snippet": "x402 is an open payment protocol that revives the HTTP 402 status code so AI agents can pay per request in stablecoins…",
   "published_at": "2025-05-06",
   "relevance": 0.92,
   "retrieved_at": "2026-09-06T20:00:01.000Z"
  },
  {
   "id": 2,
   "label": "x402 protocol docs",
   "url": "https://docs.cdp.coinbase.com/x402/welcome",
   "snippet": "A facilitator verifies and settles EIP-3009 USDC authorizations on Base…",
   "published_at": null,
   "relevance": 0.88,
   "retrieved_at": "2026-09-06T20:00:01.000Z"
  }
 ],
 "synthesis": {
  "model": "inclusionai/ling-3.0-flash",
  "prompt_tokens": 812,
  "completion_tokens": 96
 },
 "receipt": {
  "door_price": "$0.01",
  "upstream": {
   "provider": "pay-per-call x402 web search",
   "resource": "https://x402.tavily.com/search",
   "network": "eip155:8453",
   "scheme": "exact",
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "pay_to": "0xd92fab07e57dfafe9bb9dbbb3ce01651a61dca18",
   "payer": "0xC335983E964248052BAd764D6eb0801475Ec6A4C",
   "cost_atomic": 10000,
   "cost_usd": 0.01,
   "settlement": {
    "success": true,
    "transaction": "0xabc…",
    "network": "eip155:8453",
    "payer": "0xC335983E964248052BAd764D6eb0801475Ec6A4C"
   },
   "requested_at": "2026-09-06T20:00:00.000Z",
   "responded_at": "2026-09-06T20:00:01.000Z",
   "results_returned": 2,
   "upstream_response_time_ms": 1.41
  },
  "budget": {
   "per_request_cap_atomic": 10000,
   "daily_cap_atomic": 500000,
   "spent_today_atomic": 20000
  }
 },
 "generated_at": "2026-09-06T20:00:02.000Z"
}

Clients

Worked TypeScript/Python clients and MCP configs: oblique-markets/oblique-examples · Agent Skills: oblique-markets/skills

Pay per call with x402 (USDC on Base or Solana) or MPP (pathUSD on Tempo). No accounts. Machine doors: /.well-known/x402.json · /openapi.json · /llms-full.txt · MCP · humans: remote.observer