⚙

Agent API

Plug your AI agent into TaoRadar — get scores, signals, and trade via Bankr.

How it works

1Read

Fetch Scout Scores, AI theses, and trade signals from TaoRadar

2Decide

Your agent interprets signals — STRONG_BUY, BUY, SELL, etc.

3Act

Route trades through Bankr to swap alpha tokens on Base

Endpoints

All endpoints are public, unauthenticated, and return JSON. Base URL: https://taoradar.ai

GET/api/agent/top

Get top-ranked subnets by Scout Score, with full score breakdown and AI thesis.

Parameters

limitnumber— Max results (1–50, default 10)

ratingstring— Filter: ACCUMULATE, HOLD, or AVOID

curl /api/agent/topbash

curl "https://taoradar.ai/api/agent/top?limit=5&rating=ACCUMULATE"

# Response
{
  "count": 5,
  "subnets": [{
    "netuid": 18,
    "name": "Cortex.t",
    "scoutScore": 82.4,
    "rating": "ACCUMULATE",
    "ratingChange": 1,
    "scores": {
      "emission": 88, "developer": 75,
      "market": 71, "mindshare": 90,
      "convergence": 85
    },
    "thesis": "Strong emission growth with rising developer activity..."
  }]
}

GET/api/agent/subnet

Get detailed score data for a single subnet.

Parameters

netuidnumber— Subnet ID (required)

curl /api/agent/subnetbash

curl "https://taoradar.ai/api/agent/subnet?netuid=18"

# Response
{
  "netuid": 18,
  "name": "Cortex.t",
  "scoutScore": 82.4,
  "rating": "ACCUMULATE",
  "ratingChange": 1,
  "scores": { ... },
  "thesis": "Strong emission growth..."
}

GET/api/agent/signals

Actionable trade signals derived from score analysis. Returns STRONG_BUY, BUY, SELL, STRONG_SELL with reasoning.

Parameters

signalstring— Filter: STRONG_BUY, BUY, SELL, STRONG_SELL, HOLD

curl /api/agent/signalsbash

curl "https://taoradar.ai/api/agent/signals?signal=STRONG_BUY"

# Response
{
  "count": 3,
  "disclaimer": "Not financial advice. Always DYOR.",
  "signals": [{
    "netuid": 18,
    "name": "Cortex.t",
    "scoutScore": 82.4,
    "signal": "STRONG_BUY",
    "reasons": [
      "High Scout Score with ACCUMULATE rating",
      "Market score (65) lags fundamentals (84) — potential undervaluation"
    ],
    "thesis": "..."
  }]
}

GET/api/agent/history

Historical Scout Score data for a subnet over time. Useful for trend analysis and backtesting.

Parameters

netuidnumber— Subnet ID (required)

daysnumber— Lookback period (1–90, default 30)

curl /api/agent/historybash

curl "https://taoradar.ai/api/agent/history?netuid=18&days=14"

# Response
{
  "netuid": 18,
  "days": 14,
  "dataPoints": 14,
  "history": [
    { "date": "Mar 1", "score": 74 },
    { "date": "Mar 2", "score": 76 },
    ...
  ]
}

GET/api/agent/search

Search and filter subnets by name, score range, and sort by any dimension.

Parameters

qstring— Search by name or netuid

min_scorenumber— Minimum Scout Score (default 0)

max_scorenumber— Maximum Scout Score (default 100)

sortstring— Sort by: score, emission, developer, market, mindshare, convergence

orderstring— asc or desc (default desc)

curl /api/agent/searchbash

curl "https://taoradar.ai/api/agent/search?min_score=70&sort=emission&order=desc"

# Response
{
  "count": 12,
  "filters": { "q": null, "min_score": 70, "max_score": 100, "sort": "emission", "order": "desc" },
  "subnets": [{ "netuid": 18, "name": "Cortex.t", "scoutScore": 82.4, ... }]
}

GET/api/scores

Raw score dump — all subnets, all fields. For agents that want the full dataset.

curl /api/scoresbash

curl "https://taoradar.ai/api/scores"

# Returns array of all subnet scores with full breakdown

Trade via Bankr

docs.bankr.bot ↗

Use TaoRadar signals to drive trades through Bankr, an AI trading agent with wallet infrastructure. Bankr supports swaps on Base, Ethereum, Solana, and more via 0x routing.

Full agent loop — fetch signals → trade via Bankrtypescript

import { BankrClient } from "@bankr/sdk";

const BANKR_API_KEY = process.env.BANKR_API_KEY!;
const TAORADAR_API = "https://taoradar.ai/api/agent";

const bankr = new BankrClient({ apiKey: BANKR_API_KEY });

async function run() {
  // 1. Fetch actionable signals from TaoRadar
  const res = await fetch(`${TAORADAR_API}/signals?signal=STRONG_BUY`);
  const { signals } = await res.json();

  for (const signal of signals) {
    console.log(`[TaoRadar] ${signal.signal}: ${signal.name} (SN${signal.netuid})`);
    console.log(`  Score: ${signal.scoutScore} | ${signal.reasons.join(", ")}`);

    // 2. Execute trade via Bankr natural language prompt
    const job = await bankr.prompt({
      message: `Buy $50 of ${signal.name} alpha token on Base`,
    });

    console.log(`[Bankr] Job ${job.id}: ${job.status}`);
  }
}

run();

Bankr via raw HTTP (no SDK)bash

# Get TaoRadar signals
SIGNALS=$(curl -s "https://taoradar.ai/api/agent/signals?signal=STRONG_BUY")

# Extract first signal's subnet name
SUBNET=$(echo $SIGNALS | jq -r '.signals[0].name')

# Send trade to Bankr
curl -X POST https://api.bankr.bot/agent/prompt \
  -H "Authorization: Bearer $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"message\": \"Buy \$50 of $SUBNET alpha token on Base\"
  }"

Agent blueprints

Signal Scanner

BankrCron

Poll /signals every 30 min. When STRONG_BUY appears, execute via Bankr. When STRONG_SELL appears, exit position.

Thesis Summarizer

LLMSocial

Fetch /top?limit=10, pass each thesis to your LLM for a daily alpha summary posted to Farcaster or X.

Divergence Hunter

Analytics

Fetch /scores, find subnets where market score << fundamental avg. These are the undervalued gems.

Portfolio Rebalancer

BankrDCA

Map your held subnets to /signals. Sell anything that flipped to SELL, buy into new STRONG_BUY entries.

Notes

All TaoRadar endpoints are free, public, and unauthenticated.
Scores update every 30 minutes. Polling more frequently won't yield new data.
Bankr API requires its own API key — see docs.bankr.bot.
Bankr rate limits: 100 msgs/day (standard), 1,000/day (Bankr Club).
Signals are derived from Scout Scores — not financial advice.