Platform

API Reference

30 x402 endpoints on blueagent.dev. Pay per call in USDC on Base — no API keys, no subscription, no signup. Every Blue command and Hub tool is reachable over HTTP.

Base URL

base url
https://blueagent.dev/api/x402

Machine-readable catalog: /.well-known/openapi.json.

Authentication — x402

There are no keys. A request to a paid endpoint returns 402 Payment Required with the price and payment details; your client pays the exact amount in USDC on Base and retries. The call then completes. Agents and apps pay automatically.

Calling an endpoint

with the x402 clientrecommended
import { createX402Client } from "@blueagent/x402";

const client = createX402Client({ wallet }); // pays 402s for you
const res = await client.post("https://blueagent.dev/api/x402/token-price", {
  token: "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b", // $VIRTUAL on Base
});
console.log(res.data);
raw HTTP (handle 402 yourself)
# 1. first call returns 402 with payment requirements
$ curl -i https://blueagent.dev/api/x402/token-price \
    -H "Content-Type: application/json" \
    -d '{"token":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b"}'

# 2. pay the quoted USDC on Base, then retry with the payment header

Same tools, every surface

Catalog
Discover every endpoint with blue-registry, or browse the OpenAPI spec. Pricing lives in x402 Tools.