# AgenticTrade — Full Reference
Last updated: 2026-04-03

## What Is AgenticTrade?

AgenticTrade is an AI service marketplace built by JudyAI Lab. People who
build useful AI services list them here, and AI agents automatically discover,
use, and pay for those services. Think of it as a marketplace where AI agents
are the customers.

Two audiences:
1. **Service Providers** — People who have useful services (data analysis,
   translation, image processing, etc.) and want AI agents to pay for them.
2. **Agent Builders** — Developers building AI agents that need external
   capabilities like market data, code execution, or content generation.

## Platform Statistics
- Active services: 9
- Registered AI agents: 22
- Total API calls: 711
- Languages: 9 (English, Traditional Chinese, Korean, Japanese, French,
  German, Russian, Spanish, Portuguese)
- License: MIT open source
- Source: https://github.com/judyailab/agent-commerce-framework

## How It Works

### For Service Providers
1. Register at https://agentictrade.io/portal/register
2. List your service — either bring an existing HTTP API endpoint, or use
   Prompt-as-API to turn a system prompt into a paid service (no code).
3. Set your price per API call (in USDC).
4. AI agents find your service, use it, and you get paid automatically.

### For Agent Builders
1. Search the marketplace: GET /api/v1/discover?q=your_need
2. Find services that match, check pricing and quality scores.
3. Call services through the proxy: POST /api/v1/proxy/{service_id}
4. Payment happens automatically per call in USDC.

### For AI Agents (Self-Service)
1. Fetch the agent playbook: GET /api/v1/agent-playbook (no auth)
2. Self-register: POST /api/v1/agents/onboard (no auth)
3. Receive API credentials immediately.
4. Discover and consume services autonomously.

## Pricing

- Free to join for both providers and agents.
- Providers set their own per-call prices.
- Platform commission: 0% month 1, 5% months 2-3, 10% from month 4 (capped).
- Quality Rewards: providers with health score 80+ pay 8%, score 95+ pay 6%.
- Referral Program: earn 20% of platform fees from referred users, permanently.

## Payment Methods

Three payment rails:
1. **x402** — USDC on Base blockchain. Fully agent-native, per-call settlement.
2. **PayPal** — Fiat credit cards, bank transfers, PayPal balance.
3. **NOWPayments** — 300+ cryptocurrencies, auto-converted to USDC.

Providers choose how they receive settlement. Agent builders fund their
account balance in USDC.

## Quality Monitoring

Every service is monitored 24/7 by an automated quality patrol system:
- **Uptime**: Is the service online and reachable?
- **Response Time**: How fast does it respond?
- **Error Rate**: Are responses correct and error-free?

Health Score (0-100) is calculated over the last 30 days. Higher scores
unlock lower commission rates (Quality Rewards).

## API Reference Summary

Base URL: https://agentictrade.io/api/v1
Auth: Bearer token (format: key_id:secret)
Rate limit: 60 requests/minute

### Discovery Endpoints (public, no auth)
- GET /api/v1/discover — Search services by query, category, tags, price
- GET /api/v1/discover/categories — List all categories
- GET /api/v1/discover/trending — Trending services by usage
- GET /api/v1/discover/recommendations/{agent_id} — Personalized picks
- GET /api/v1/agent-playbook — Machine-readable integration guide

### Service Endpoints
- GET /api/v1/services — List all active services
- GET /api/v1/services/{id} — Get service details
- POST /api/v1/services — Register a new service (auth required)

### Proxy Endpoints (auth required)
- POST /api/v1/proxy/{service_id}/{path} — Call a service through proxy
  Handles authentication, billing, and rate limiting automatically.

### Agent Endpoints
- POST /api/v1/agents/onboard — Self-register (no auth, returns API key)
- GET /api/v1/agents/{agent_id}/dashboard — Agent stats (auth required)

### Billing Endpoints (auth required)
- GET /api/v1/billing/balance — Check account balance
- POST /api/v1/billing/deposit — Create deposit invoice

### MCP Integration
- GET /api/v1/mcp/descriptor — MCP tool descriptor (machine-readable)
- Install: npx clawhub@latest install agentictrade

## Agent Discovery Protocols

AgenticTrade supports all major agent discovery standards:
- **MCP** (Model Context Protocol): /.well-known/mcp.json
- **OpenAI Plugin**: /.well-known/ai-plugin.json
- **ACDP** (Agent Communication Discovery): /.well-known/agents.json
- **OpenAPI 3.0**: /api/v1/openapi.json (auto-generated)
- **llms.txt**: /llms.txt (this file's summary version)
- **AdCP**: /.well-known/adagents.json

## SDK & Integration

Python SDK:
```
pip install agentictrade

from agentictrade import Agent
agent = Agent(api_key='your_key')
services = agent.discover('crypto analysis')
result = agent.call(services[0].id, {'symbol': 'BTC'})
```

MCP Integration (Claude Code):
```
npx clawhub@latest install agentictrade
```

Direct HTTP:
```
curl -H 'Authorization: Bearer KEY_ID:SECRET' \
  https://agentictrade.io/api/v1/discover?q=market+data
```

## Security

- Provider API keys never leave the provider's machine (Proxy Key system)
- All connections require HTTPS
- Rate limiting on all endpoints (60 req/min default)
- Input validation and SQL injection prevention
- HSTS, CSP, and security headers enabled
- Open source — full code audit available on GitHub

## About

- Built by JudyAI Lab (https://judyailab.com)
- Founded by Judy Wang
- Website: https://agentictrade.io
- Contact: hello@agentictrade.io
- GitHub: https://github.com/judyailab/agent-commerce-framework
- License: MIT