# AlgoVault Scan Trade Calls

> AlgoVault Scan Trade Calls is a paid API for AI agents from api.algovault.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Scans the top-N perpetual futures markets by open interest on a given exchange and returns ranked BUY/SELL trade calls with confidence scores and market regime classifications in a single call.

## Facts

- Endpoint: POST https://api.algovault.com/x402/scan_trade_calls
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/algovault-scan-trade-calls-2970565b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c3DsqMXeBuwGlgzQ5VKfE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability algovault-scan-trade-calls-2970565b -d '<json body>'
```

Example prompt: Scan the top 30 Binance perpetual futures markets on the 1-hour timeframe and show me the top 15 BUY or SELL calls with a confidence of at least 60 — I want to see which setups look strongest right now.

## When to prefer this

Use this endpoint when an agent needs to survey many perpetual futures markets simultaneously and wants the highest-confidence actionable setups ranked in one call. Prefer this over the single-market `get_trade_signal` endpoint when you don't have a specific symbol in mind and want to discover the best opportunities across an entire venue. Ideal for systematic scanning workflows, opportunity discovery, and portfolio-wide signal generation on derivatives exchanges.

## Known failure modes

- Invalid exchange enum value returns a 400 validation error
- topN or limit out of range (outside 1–100) returns a 400 error
- minConfidence out of range (outside 0–100) returns a 400 error
- Payment not processed or x402 header missing returns a 402 Payment Required
- Exchange API unavailable or rate-limited may return a 503 or timeout
- No markets meet the minConfidence threshold resulting in an empty list
- Unsupported timeframe value returns a 400 validation error

## How this service works

Returns the actionable BUY / SELL trade calls across the top-N perpetual-futures markets by open interest on a venue — each with a 0–100 confidence and the current market regime — so an agent can scan the whole board in one call instead of polling symbols one-by-one. HOLD markets are excluded by default; flat per-scan price. Read-only market scan, informational only. Use when an agent wants the best setups across many markets at once; for one specific market use `get_trade_signal`.

## Output

A ranked list of up to `limit` BUY or SELL trade calls across the top-N perpetual futures markets by open interest, each including the trading symbol, directional verdict, a 0–100 confidence score, and the current market regime classification. HOLD signals are excluded by default.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topN": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1,
   "description": "How many top-open-interest markets to scan (1–100)."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum ranked calls to return (1–100)."
  },
  "exchange": {
   "enum": [
    "HL",
    "BINANCE",
    "BYBIT",
    "OKX",
    "BITGET",
    "ASTER",
    "BINGX",
    "GATE",
    "HTX",
    "KUCOIN",
    "MEXC",
    "PHEMEX",
    "WHITEBIT",
    "XT",
    "WEEX"
   ],
   "type": "string",
   "default": "BINANCE",
   "description": "Promoted derivatives venue to scan."
  },
  "timeframe": {
   "enum": [
    "1m",
    "3m",
    "5m",
    "15m",
    "30m",
    "1h",
    "2h",
    "4h",
    "8h",
    "12h",
    "1d"
   ],
   "type": "string",
   "default": "15m",
   "description": "Candle timeframe for each verdict."
  },
  "includeHolds": {
   "type": "boolean",
   "default": false,
   "description": "Append HOLD markets after the actionable calls."
  },
  "minConfidence": {
   "type": "number",
   "maximum": 100,
   "minimum": 0,
   "description": "Drop non-HOLD calls below this confidence (0–100)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/algovault-scan-trade-calls-2970565b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.algovault.com](https://www.zero.xyz/host/api.algovault.com/llms.txt)