Agent SignalAgent Signal
AI TRADING SIGNAL PLUGIN

Live signals for agents that trade

Give your AI agent LONG/FLAT/SHORT trading signals, COMPASS macro scores, and RADAR calendar risk — via a simple REST API with \$0.01 per call x402 micropayments. No subscription. No API key. Just pay per signal.

Build a StrategyBrowse Strategies

How it works

First, get a strategy_id. There are two ways — pick whichever fits:

Use a public template

ZERO SETUP

Call GET /api/strategy (free, no sign-in, no wallet) to list public template strategies and grab any id. This is the fastest path for a fully autonomous agent — no human required at any point.

Build a custom strategy

HUMAN OR WALLET

A signed-in human can define entry/exit rules in NAVIGATOR (RSI, MACD, COMPASS, RADAR, ADX, ATR, Hyperliquid triggers). Or an agent can call POST /api/strategy directly with a signature-verified wallet identity — no session needed — as long as that wallet has an active trader or alpha subscription (get one via POST /api/subscribe/usdc, x402 USDC on Base). The agent signs a short message with its private key to prove wallet control (X-Wallet-Address / X-Wallet-Message / X-Wallet-Signature headers) — a bare address is public and proves nothing on its own. Unsubscribed wallets get a 403 with subscribe instructions instead of a silent failure.

Then, either way:

01

Agent fetches signal

Your agent calls GET /api/strategy/{id}/signal. The endpoint returns LONG, FLAT, or SHORT — plus the raw COMPASS score, every condition result, and current price.

02

x402 pays automatically

The first call gets a 402 with payment details. Your x402-enabled client pays $0.01 from its EVM wallet and retries — no human input. Fully autonomous.

MCP installation

LIVE

Add AgentSignal to any MCP-compatible client in one step — Claude Code, Cursor, Windsurf, and more. The MCP server handles x402 payments automatically. View source ↗ — not to be confused with the Desktop Trader, a separate app that executes trades against an exchange.

Claude Code — .claude/mcp.json
{
  "mcpServers": {
    "agentsignal": {
      "command": "npx",
      "args": ["-y", "@agent-signal/mcp@latest"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x..."
      }
    }
  }
}
Claude Code CLI
claude mcp add agentsignal \
  --command npx \
  --args "-y @agent-signal/mcp@latest"
Set AGENT_PRIVATE_KEY to your EVM wallet private key. The MCP server handles x402 payments automatically — your agent never needs to reason about payment logic.

REST API

LIVE NOW

Works today with any HTTP client. Agents using x402 handle payments automatically. All other endpoints are free. Machine-readable spec: /openapi.json.

EndpointDescriptionCost
GET

/api/strategy/{id}/signal

Live LONG / FLAT / SHORT signal for a strategy. Includes COMPASS score, per-condition results, and current price.

$0.01
GET

/api/strategy/{id}/signals

30-day stored signal history for a strategy. Returns the last computed signal rows — not a live fetch.

Free
GET

/api/crypto-radar

Latest Crypto RADAR report — AI-generated crypto market risk assessment.

Free
POST

/api/backtest

Run a full backtest for a strategy. Returns equity curve, Sharpe, win rate, max drawdown.

$0.05
GET

/api/strategy

List all public strategies and templates available to trade. Pass a signature-verified wallet identity (X-Wallet-Address/-Message/-Signature) to also list your wallet's own saved strategies.

Free
POST

/api/strategy

Create a custom strategy. Free itself, but requires a signature-verified wallet identity for a wallet with an active trader/alpha subscription (or a signed-in session) — unsubscribed wallets get a 403.

Free*
POST

/api/subscribe/usdc

Subscribe a wallet to trader ($9/mo, $90/yr) or alpha ($29/mo, $290/yr) via x402 — required before that wallet can create strategies.

$9–$290
POST

/api/strategy/{id}/subscribe

Prepay for a period of automated polling at a chosen interval so the trader isn't charged per call. Price = (60/interval) × 24 × days × $0.01.

Varies
POST

/api/strategy/{id}/subscription/adjust

Slow down an active subscription's interval for free, or get a 402 upcharge quote to speed it up.

Free / Varies

Signal response

Every signal call returns the direction, the full COMPASS macro context, and a per-condition breakdown so your agent knows why the signal fired.

Request
curl -H "Accept: application/json" \
  https://agentsignal.app/api/strategy/ba5a1fbc-7196-454a-b828-cf083e8527a8/signal
Response
{
  "strategy_id": "ba5a1fbc-7196-454a-b828-cf083e8527a8",
  "strategy_name": "BTC 10× Long",
  "symbol": "BTC-USD",
  "date": "2026-04-05",
  "signal": "LONG",
  "price": 82450.12,
  "compass": {
    "score": 3,
    "label": "Risk On"
  },
  "conditions": {
    "entry": [
      {
        "source": "compass",
        "field": "score",
        "op": "lte",
        "value": -3,
        "result": true
      }
    ],
    "exit": [
      {
        "source": "radar",
        "field": "score",
        "op": "gte",
        "value": 0,
        "result": false
      }
    ]
  }
}

Integration examples

Python (httpx)
import httpx

# x402-enabled client automatically handles micropayments
client = httpx.Client()

response = client.get(
    "https://agentsignal.app/api/strategy/ba5a1fbc-7196-454a-b828-cf083e8527a8/signal",
    headers={"Accept": "application/json"},
)
signal = response.json()
print(f"Signal: {signal['signal']} ({signal['symbol']})")

Try it now

Paste any of these into Claude Code, Cursor, or any agent with HTTP tool access.

Check live signal

“What is the current signal for my BTC strategy? Fetch it from https://agentsignal.app/api/strategy/ba5a1fbc-7196-454a-b828-cf083e8527a8/signal and tell me whether to be long or flat.”

Macro context

“Get the latest COMPASS score from agentsignal.app and tell me if macro conditions are risk-on or risk-off right now.”

Run a backtest

“Run a backtest on strategy ba5a1fbc-7196-454a-b828-cf083e8527a8 from 2025-01-01 to today using $10,000 starting capital. Report the return, Sharpe ratio, and max drawdown.”

Full pre-trade check

“Before I trade: fetch the COMPASS score, RADAR risk score, and my BTC strategy signal from agentsignal.app. Give me a go / no-go recommendation.”

What agents can access

COMPASS Score

Daily

Macro risk-on/off score from -7 to +7. Aggregates VIX, SPY/QQQ momentum, yield curve, credit spreads, and BTC dominance.

RADAR Risk

Daily

Calendar risk score 0 to -6. Measures proximity to FOMC meetings and CPI releases — events that historically increase volatility.

Crypto RADAR

Every 30 min

AI-generated crypto market assessment. Updated every 30 minutes with funding rate context, regulatory sentiment, and on-chain signals.

Strategy Signals

$0.01/call

LONG/FLAT/SHORT for any NAVIGATOR strategy. Per-condition results show exactly which rules fired and which didn't.

Signal History

Free

Last 30 stored signals for any strategy. Use this to understand regime context — not a live fetch, but useful for trend and pattern checks.

Backtest Engine

$0.05/call

Full historical simulation with equity curve, Sharpe ratio, Sortino, max drawdown, win rate, and liquidation simulation.

Pricing

\$0.01

per live signal fetch

Paid automatically via x402 on Base. Your agent's EVM wallet covers the cost without any human interaction. No monthly commitment, no API key rotation.

✓ 100 signal calls = $1.00

✓ 1,000 signal calls = $10.00

✓ No rate limit

Free

everything else

Signal history, COMPASS scores, RADAR reports, and Crypto RADAR are free — no wallet needed.

✓ Signal history (30 days)

✓ COMPASS + RADAR

✓ Crypto RADAR

x402 payments settle on Base via USDC. The x402 spec is open source — build your own x402 client in any language.

Common questions

Can my agent create a strategy without a human?

Yes, if its wallet has an active trader or alpha subscription. POST /api/strategy accepts a signature-verified wallet identity instead of a session cookie — sign a short message with your private key and send X-Wallet-Address, X-Wallet-Message, and X-Wallet-Signature headers; a bare address alone is rejected. Subscribe that wallet first via POST /api/subscribe/usdc (x402 USDC on Base, $9/mo trader or $29/mo alpha). Unsubscribed wallets get a 403 with subscribe instructions rather than a silent failure. You don't need a custom strategy to get started at all, though: GET /api/strategy lists public template strategies for free with no wallet or sign-in, and any template's id works identically to a custom one for get_signal, run_backtest, and subscriptions.

Does my agent need a wallet?

Only for live signal fetches ($0.01 each). Stored signal history, COMPASS, RADAR, and Crypto RADAR are free. Backtests cost $0.05 per call. The live signal endpoint computes fresh against current market data — that's what costs $0.01. History returns the last stored row and requires no wallet.

Which AI agents and frameworks work?

Any agent that can make HTTP requests. The x402 payment flow is handled by the x402 client library, available for Python, Node.js, and Go. Claude Code, LangChain, CrewAI, AutoGen, and raw API agents all work.

What is the signal latency?

COMPASS and RADAR update once daily at 6:30 AM UTC. Crypto RADAR updates every 30 minutes. Live strategy signals compute in real-time on demand — typical response time is 1–3 seconds.

Can I build strategies for stocks and ETFs as well as crypto?

Yes. NAVIGATOR supports any Yahoo Finance ticker (QQQ, SPY, NVDA, etc.) and any CoinGecko crypto ticker (BTC, ETH, SOL). Signals and backtests work for both. Intraday Trigger conditions are currently Hyperliquid (crypto-only).

Is there a browser redirect when my agent hits the signal endpoint?

No. Set Accept: application/json and the endpoint returns JSON directly. Browser requests (Accept: text/html) redirect to the strategy page — agent requests go straight to the data.

Get started

Build your first agent strategy

Create a strategy in NAVIGATOR, save it, and you have a live signal endpoint your agent can call in minutes.

Open NAVIGATORBrowse StrategiesDesktop Trader ↗