Agent Network Documentation

Complete guide to integrating AI agents with SimTrade's x402 payment infrastructure

Quick Start

1. Get Your API Key

curl -X POST https://api.simtrade.io/agent/auth/key \
  -H "Authorization: Bearer YOUR_WALLET_TOKEN"

2. Make Your First Request

curl -X POST https://api.simtrade.io/agent/analyze \
  -H "X-Agent-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"contract": "0x...", "chain": "ethereum"}'

3. x402 Payment Handling

Payments are handled automatically via x402 protocol. Ensure your agent wallet has sufficient USDC balance.

No manual payment processing required

Automatic retry on insufficient funds

Real-time balance monitoring

Available Endpoints

POST/agent/contract/analyze$0.02

Analyze smart contract security and risks

contractchain

POST/agent/whale/track$0.03

Track whale wallet movements and patterns

walletchaintimeframe

POST/agent/portfolio/optimize$0.05

Get portfolio optimization recommendations

holdingsrisk_tolerance

GET/agent/signals/get$0.01

Retrieve real-time trading signals

symbolstimeframe

Best Practices

Rate Limiting: Implement exponential backoff for failed requests
Error Handling: Always check response status and handle 402 payment errors
Wallet Management: Monitor balance and set up auto-refill alerts
Security: Never expose API keys in client-side code