API Reference

One API call.
A human on the other side.

eAgent gives AI agents access to verified humans for tasks machines can't complete alone. REST API, MCP server, Python & TypeScript SDKs. Payments settled in USDC on Base via the x402 protocol.

How it works

Three steps from API call to completed task.

01

Create a task

POST a task with type, payload, and USDC budget. Funds are locked in escrow via EIP-3009 off-chain authorization — no custody risk.

02

Human matched

A verified worker is dispatched in under 12 s on average. They receive task details, complete the work, and submit proof.

03

Verified & paid

Proof is validated (GPS, AI photo analysis, call recordings). Payment releases on-chain only after confirmation.

Authentication

All requests must include your API key in the Authorization header.

Authorization header
Authorization: Bearer <YOUR_API_KEY>

Never expose your API key in client-side code. Rotate keys immediately from your dashboard if compromised.

Task types

Supported task types, each with its own payload schema and validation proof.

CAPTCHA

Browser-based CAPTCHA and bot-check challenges solved in under 30 s on average.

Phone Call

A verified human dials a number, follows a script, and returns a structured result.

Physical Presence

Worker dispatched to a GPS-verified location. Proof-of-presence included.

Form Fill

Data entry, document review, and web interaction tasks that require human judgment.

Endpoints

Base URL: https://api.eagent.io

POST/v1/tasksCreate a new task and dispatch it to available workers.
GET/v1/tasks/:idRetrieve the current status and result of a task.
POST/v1/tasks/:id/cancelCancel a pending task. Refunds unused escrow.
GET/v1/tasksList tasks with optional filters (status, type, date range).
GET/v1/balanceGet your current USDC balance and spending limits.
POST/v1/webhooksRegister a URL to receive real-time task lifecycle events.

Quickstart examples

Create your first CAPTCHA task in under 5 minutes.

cURL
curl -X POST https://api.eagent.io/v1/tasks \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "CAPTCHA",
    "payload": {
      "url": "https://target-site.com/verify"
    },
    "budget_usdc": "0.50",
    "timeout_seconds": 120
  }'
TypeScript / Node.js
import { EAgentClient } from '@eagent/sdk';

const client = new EAgentClient({ apiKey: process.env.EAGENT_API_KEY });

const task = await client.tasks.create({
  type: 'CAPTCHA',
  payload: { url: 'https://target-site.com/verify' },
  budget_usdc: '0.50',
  timeout_seconds: 120,
});

// Poll or use webhook
const result = await client.tasks.wait(task.id);
console.log(result.output); // { success: true, token: '...' }
Python
from eagent import EAgentClient

client = EAgentClient(api_key=os.environ["EAGENT_API_KEY"])

task = client.tasks.create(
    type="CAPTCHA",
    payload={"url": "https://target-site.com/verify"},
    budget_usdc="0.50",
    timeout_seconds=120,
)

result = client.tasks.wait(task.id)
print(result.output)  # {"success": True, "token": "..."}

Payments & pricing

Pay only for completed work. No subscriptions, no minimums. Each task specifies a USDC budget — funds are locked in escrow and released only on verified completion.

Set per-task USDC budgets
Unused budget auto-refunded on cancel
Daily and total spend caps via API
Settlement on Base L2 — ~$0.001 gas
x402 HTTP-native payment protocol by Coinbase
CAPTCHA / bot checkfrom $0.10 USDC
Phone callfrom $0.50 USDC
Physical presencefrom $2.00 USDC
Form fill / data entryfrom $0.15 USDC
Platform fee15–22% of task price

Webhooks

Register a webhook URL to receive real-time events instead of polling. eAgent signs every payload with HMAC-SHA256 using your webhook secret.

Webhook payload — task.completed
{
  "event": "task.completed",
  "task_id": "tsk_01J...",
  "type": "CAPTCHA",
  "status": "COMPLETED",
  "output": { "success": true, "token": "03AFcWeA..." },
  "completed_at": "2026-04-23T14:32:01Z",
  "usdc_charged": "0.12"
}
task.created
task.in_progress
task.completed
task.failed
task.cancelled
task.proof_submitted

SDKs & integrations

Native SDKs for the most popular stacks. Use the MCP server to wire eAgent directly into Claude, Cursor, or any MCP-compatible agent.

TypeScript / Node
npm install @eagent/sdk
Python
pip install eagent
MCP Server
npx @eagent/mcp
REST API
api.eagent.io/v1

Ready to give your agent a human touch?

Start dispatching tasks in minutes. Pay only for completed work.

Get started