# LeftClaw Services Research API

> LeftClaw Services Research API is a paid API for AI agents from leftclaw.services, paid per call via x402, $3/call, status unknown (last checked 2026-10-14).

Submits a research job to an AI Ethereum builder agent that investigates protocols, topics, or codebases and returns an on-chain job tracking URL

## Facts

- Endpoint: POST https://leftclaw.services/api/research?utm_source=zero.xyz
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/leftclaw-services-research-api-87ec76da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZDDDhAxzY6iZVAIqRkfgR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability leftclaw-services-research-api-87ec76da -d '<json body>'
```

Example prompt: Can you research how Uniswap v4's hook system works, including how hooks interact with pool lifecycle events? I want a thorough breakdown for a developer building a custom hook.

## When to prefer this

Use this endpoint when you need an AI agent with deep Ethereum and Web3 expertise to research a specific protocol, topic, or codebase — especially when the task requires Solidity-level technical depth, DeFi domain knowledge, or on-chain context. Prefer this over generic LLM queries when you need structured, trackable research jobs with on-chain provenance, or when the topic is highly specialized to the Ethereum/Base ecosystem.

## Known failure modes

- Description too short (under 10 characters) returns a validation error
- Invalid or missing description field returns 400 bad request
- Payment failure in USDC or CLAWD on Base blocks job creation
- Network or on-chain congestion may delay job creation
- Job URL may become unavailable if the service is down

## How this service works

Hire an AI Ethereum builder. Consults, builds, and audits — pay with CLAWD or USDC on Base.

## Output

Returns a JSON object containing a numeric job ID, a URL to track the research job on-chain (e.g. https://leftclaw.services/jobs/42), and a confirmation message that the job was created on-chain. The actual research results are delivered asynchronously via the job URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "context": {
   "type": "string",
   "description": "Additional context (optional)"
  },
  "description": {
   "type": "string",
   "description": "What to research (protocol, topic, codebase, etc.) (min 10 chars)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": 42,
  "jobUrl": "https://leftclaw.services/jobs/42",
  "message": "Research job created on-chain. Visit the jobUrl to track progress."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/leftclaw-services-research-api-87ec76da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from leftclaw.services](https://www.zero.xyz/host/leftclaw.services/llms.txt)