Skip to main content
POST
/
v1
/
tools
/
research
curl -X POST https://win.oneshotagent.com/v1/tools/research \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "topic": "Latest developments in AI agent frameworks",
    "depth": "deep"
  }'

{
  "request_id": "req_research_xyz",
  "status": "pending",
  "tool": "research",
  "message": "Job queued successfully."
}

​
Authentication

Requires x402 payment proof in the X-Payment-Proof header.

​
Request Body

​
topic
string
required
Research topic or question
​
depth
string
default:"quick"
Research depth: quick or deep

​
Response

​
request_id
string
Job ID for tracking research progress
​
status
string
Job status: pending, processing, completed, or failed
​
message
string
Status message
curl -X POST https://win.oneshotagent.com/v1/tools/research \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "topic": "Latest developments in AI agent frameworks",
    "depth": "deep"
  }'

{
  "request_id": "req_research_xyz",
  "status": "pending",
  "tool": "research",
  "message": "Job queued successfully."
}

​
Research Depths

  • quick: Fast research with 5-10 sources (2-3 minutes)
  • deep: Comprehensive research with 20+ sources (5-10 minutes)

​
Notes

  • Results include markdown report with citations
  • Sources are verified and ranked by relevance
  • Job status can be polled using the request_id