Agent_3 API

API Currently in Testing — Endpoints are not yet live. Public API access expected after Agentic Mode release. Join the waitlist

API REFERENCE v1.0

COMING SOON

Build with the A3 Neural Gateway

Integrate Agent_3's powerful trading LLM directly into your applications. The same AI that powers our platform — available via simple REST endpoints, paid with $A3 tokens.

Developers can enable their users to execute trades, analyze markets, and automate complex strategies using natural language — without building the infrastructure themselves.

View Integration Guide Explore Endpoints

Why Use the Agent_3 API?

Same LLM, Your App

Access the exact same AI trading intelligence that powers the Agent_3 platform. Natural language trading, market analysis, and strategy execution in your own applications.

Pay with $A3

Fund your API account with $A3 tokens. Every API call draws from your token balance, creating real utility and demand for the ecosystem token.

Secure by Design

Session keys and Privy wallet integration ensure your users' funds stay safe. Non-custodial architecture means you never hold user assets.

Quickstart Guide

Get up and running with the Agent_3 API in four simple steps.

Create Account

Fund with $A3

Purchase $A3 tokens and deposit them into your API account. Tokens are consumed as you make API calls.

Setup Privy Wallet

Connect or create a Privy wallet for secure transaction signing. This enables trade execution via API.

Generate API Key

Create your API key in the dashboard. Use it to authenticate all requests to the Agent_3 API.

API Endpoints

Complete reference for all A3 Neural Gateway endpoints. Each endpoint includes authentication requirements, rate limits, pricing, and full request/response schemas.

POST/v1/neural/completions

Submit natural language queries to the A3 Neural Gateway. The LLM processes your request and returns trading insights, market analysis, or strategy recommendations.

Authentication

Bearer Token (API Key)

Rate Limit

100 requests/minute

Cost

0.001 - 0.005 $A3 per request (based on token count)

Request Body

{
  "model": "a3-neural-v1",
  "messages": [
    {
      "role": "system",
      "content": "You are a DeFi trading assistant with access to real-time market data."
    },
    {
      "role": "user", 
      "content": "Analyze ETH/USDT on Binance. What's the current trend and where are the key support levels?"
    }
  ],
  "context": {
    "portfolio": "0x...",           // Optional: Include portfolio for personalized advice
    "risk_tolerance": "moderate",   // low, moderate, aggressive
    "timeframe": "4h"               // 1m, 5m, 15m, 1h, 4h, 1d, 1w
  },
  "stream": false,                  // Set true for streaming responses
  "max_tokens": 2000,
  "temperature": 0.7
}

Authentication

All API requests require authentication. Use your API key for standard requests, and session keys for delegated trade execution.

API Keys

Generated in your dashboard. Include in all requests as a Bearer token.

Authorization: Bearer a3_live_xxxxx

API keys have full account access. Never expose them client-side.

Session Keys

Time-limited keys for delegated signing. Required for /trade/intent endpoint.

session_key: sk_live_a3_xxxxx

Session keys expire after 24h and have permission-based limits.

Error Codes

Standard HTTP status codes with detailed error messages to help you debug integration issues.

Code	Status	Description
400	Bad Request	Invalid request body or parameters. Check the error message for specific field issues.
401	Unauthorized	Missing or invalid API key. Ensure your Bearer token is correct and active.
403	Forbidden	Valid API key but insufficient permissions. Check your account tier or session key permissions.
404	Not Found	Endpoint or resource doesn't exist. Verify the URL path.
409	Conflict	Session key already exists or trade conflicts with pending order.
422	Unprocessable	Request understood but cannot be processed. Common for invalid trade intents or unsupported tokens.
429	Rate Limited	Too many requests. Back off and retry with exponential backoff. Check X-RateLimit-Reset header.
500	Server Error	Internal error on our end. Retry after a few seconds. If persistent, contact support.
503	Service Unavailable	API temporarily down for maintenance. Check status.agent3.io for updates.

Token-Based Pricing

No monthly fees. No credit cards. Just $A3 tokens. Pay only for what you use.

LLM Queries

~0.001 $A3

per request

Market analysis
Strategy suggestions
Portfolio insights
Risk assessment

Trade Execution

~0.01 $A3

per transaction + gas

Natural language trades
Multi-chain support
MEV protection
Optimal routing

SDKs & Libraries

Official client libraries to accelerate your integration. More languages coming soon.

Coming Soon

JavaScript / TypeScript

npm install @agent3/sdk

Full-featured SDK with TypeScript support, streaming, and React hooks.

Coming Soon

Python

pip install agent3

Async-first Python SDK for backend services and trading bots.

Planned

Go

go get agent3.io/sdk

High-performance Go client for low-latency applications.

API Access Opens After Public Agentic Release

Ready to Build?

The A3 Neural Gateway API is currently in closed testing. Join the waitlist to get early access and be notified when we launch publicly after the Agentic Mode release.

Join the Waitlist Read Full Documentation

Early access developers will receive priority support and discounted API rates.