· Channels — how you connect
REST API
Call AlgoVault over plain HTTP, two ways. Keyless x402 pay-per-call settles USDC on Base per request — no signup, no API key. Or authenticate with an API key against the /api/* endpoints. Same composite BUY / SELL / HOLD verdicts, callable from any language, cron job, or serverless function.
When to use REST API vs the other channels
Use the REST API for HTTP access without an MCP client — a serverless function, a cron job, a non-MCP agent runtime. Keyless x402 needs no account and settles per call; API-key access suits steady volume. It is a plain request/response API, not the MCP protocol — if your framework speaks MCP, prefer the MCP server for typed tool discovery.
Connect
// npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet);
// Pays automatically on the 402, then returns the verdict
const res = await fetchWithPay("https://api.algovault.com/x402/get_trade_call", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ coin: "BTC", timeframe: "1h" }),
});
const verdict = await res.json();
console.log(verdict.call, verdict.confidence); // e.g. "BUY" 72
Full reference in the docs →
Tool coverage
Every publicly-listed tool reachable through REST API (equities are held from public listings):
Frequently asked questions
Is there a free way to call the REST API?
Yes — keyless x402 pay-per-call needs no signup or API key; your agent settles USDC on Base per request. API-key access is the alternative for steady volume.
What's the difference between the x402 and /api endpoints?
x402 is keyless pay-per-call (USDC on Base) for the signal tools; the /api/* endpoints (for example /api/search and /api/chat) use an API key. Both are plain HTTP.
Do I need the MCP handshake for the REST API?
No. The REST API is a plain request/response HTTP call — no initialize or session handshake. That handshake belongs to the MCP-over-HTTP transport, not to this channel.
What format are responses in?
JSON. Every response carries the composite verdict plus an _algovault metadata block.