agents.eco — AI Agent Infrastructure

Quick Start

Get up and running in 3 steps:

1

Register & get your API key

Connect your wallet, deposit USDC on Base, and sign to register. You'll receive an API key starting with ak_.

2

Create an AI agent

curl -X POST https://agents.eco/v1/agents \
  -H "Content-Type: application/json" \
  -H "X-AGENTS-ECO-KEY: ak_your_key_here" \
  -d '{
    "name": "My Assistant",
    "systemPrompt": "You are a helpful assistant.",
    "memoryEnabled": true,
    "reasoningEnabled": false
  }'

3

Chat with your agent

curl -X POST https://agents.eco/v1/agents/AGENT_ID/chat \
  -H "Content-Type: application/json" \
  -H "X-AGENTS-ECO-KEY: ak_your_key_here" \
  -d '{"message": "Hello! What can you do?"}'

Authentication

API Key Authentication

All API requests require the X-AGENTS-ECO-KEY header.

# Include in every request
curl -H "X-AGENTS-ECO-KEY: ak_your_key_here" https://agents.eco/v1/wallet/balance

Wallet Session Authentication

Human users can sign in with their wallet. Session tokens use the Authorization: Bearer header and expire after 24 hours.

Idempotency

All POST requests should include an Idempotency-Key header with a unique string. If a duplicate key is received within 24h, the original response is returned.

AI Agents

Create AI agents with a custom system prompt. Optionally enable memory (Voyage AI embeddings for conversation recall) and reasoning (multi-step thinking for complex tasks).

Feature	Cost	Description
Base creation	$1.00	Agent with system prompt, qwen3-4b model
+ Memory	+$5.00	Voyage AI embeddings for conversation recall
+ Reasoning	+$5.00	Multi-step thinking before responding

Chat messages are billed per token usage. Model: qwen3-4b on Venice.ai.

Inference

Models & Pricing

All billing uses USD credits. 1 credit = $0.000001 USD (matches USDC 6 decimals). 1 USDC deposit = 1,000,000 credits.

Model	Input Price	Output Price	Context
`qwen3-4b`	$0.075/1M tokens(75 credits/1K)	$0.225/1M tokens(225 credits/1K)	32K
`llama-3.2-3b`	$0.225/1M tokens(225 credits/1K)	$0.90/1M tokens(900 credits/1K)	128K

Prices include 50% markup over Venice base rates. Powered by Venice.ai private inference.

Wallet & Billing

Deposit Flow

1. Get the deposit address via the API or wallet page.

2. Send USDC on Base (chain ID 8453) directly to the deposit address using a standard ERC-20 transfer.

3. Submit the transaction hash to verify and credit your account.

USDC on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (6 decimals)

Errors & Rate Limits

Error Format

{
  "error": "Human-readable error message",
  "statusCode": 400
}

HTTP Status Codes

400Bad request — missing or invalid parameters

401Unauthorized — invalid or missing API key

402Payment required — insufficient balance

404Not found — resource doesn't exist

409Conflict — resource already exists

429Rate limited — includes retryAfterMs

500Internal server error

Rate Limits

Default limits per agent: 60 requests/minute and 10,000 requests/day. When rate limited, the response includes retryAfterMs indicating when to retry.

Documentation