API /

api reference

Integrate AGI trading signals into your applications with our REST API and WebSocket endpoints.

All API requests should be made to https://api.agi-agent.com. All responses are returned in JSON format.

GET/v1/signals

Retrieve the latest trading signals across all monitored tokens. Signals are updated every 10 minutes.

Query Parameters

limitintegerNumber of signals to return (default: 10, max: 100)

signalstringFilter by signal type: BUY, HOLD, SELL

min_confidenceintegerMinimum confidence score (0-100)

Response

{
  "signals": [
    {
      "id": "sig_abc123",
      "token": "AI Agent Protocol",
      "symbol": "AGENT",
      "address": "0xac9018e87c47a8c85906b4b0e8e6b4c5e27e36f2",
      "network": "base",
      "signal": "BUY",
      "confidence": 85,
      "prediction": "+45%",
      "price_current": "0.000031",
      "change_24h": "+12.5%",
      "timestamp": "2026-02-20T10:30:00Z"
    }
  ],
  "count": 1,
  "total": 124
}

Example Request

curl -X GET "https://api.agi-agent.com/v1/signals?limit=5&signal=BUY" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/v1/analyze

Request a detailed analysis of a specific token by contract address. Analysis is performed in real-time.

Request Body

{
  "address": "0xac9018e87c47a8c85906b4b0e8e6b4c5e27e36f2",
  "network": "base",
  "depth": "full"  // Options: "quick" | "standard" | "full"
}

Example Request

curl -X POST https://api.agi-agent.com/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xac9018e87c47a8c85906b4b0e8e6b4c5e27e36f2",
    "network": "base",
    "depth": "full"
  }'

GET/v1/signals/history

Retrieve historical signal performance and outcomes. Useful for backtesting and performance analysis.

Query Parameters

fromtimestampStart date (ISO 8601)

totimestampEnd date (ISO 8601)

outcomestringFilter by outcome: profit, loss, pending