Single-page docs · machine-readable

API Reference

Every endpoint is documented once, on this page. For programmatic discovery, use GET /registry — it publishes the same structure as JSON.

Endpoints

GET /registry

Purpose: Machine-readable capability catalog. Source of truth for the network.
Auth: none (public)
Rate limit: reasonable use, cached 60s
Content-Type: application/json
curl https://agentic.advalorem.io/registry

Returns a top-level object with network metadata and a capabilities array. Each capability entry declares its own endpoint, price, currency, latency_ms_p50, latency_ms_p99, authentication, x402, input_schema, output_schema, availability, example_request, example_response. See the catalog for full detail.

GET /status/health

Purpose: Aggregated live telemetry across all capabilities + underlying infrastructure.
Auth: none
Cache: 10 seconds server-side, no client cache
curl https://agentic.advalorem.io/status/health

Returns a single JSON document containing per-capability status (up / degraded / down / planned), latency samples, and rbuilder infrastructure state (bids received, submits, accepted, relay list, BLS pubkey). Suitable for agent liveness checks.

POST https://builder.advalorem.io/rpc — bundle-submit

Purpose: Submit an Ethereum bundle to our own rbuilder for block construction and 4-relay fanout.
Auth: X-Flashbots-Signature: 0xADDR:0xSIG
Price: $0.10 per bundle (settlement out-of-band, x402 planned)
Rate limit: 10 req/s per IP, burst 20
Latency: ~420ms p50, ~1200ms p99
curl -X POST https://builder.advalorem.io/rpc \
  -H 'Content-Type: application/json' \
  -H 'X-Flashbots-Signature: 0xADDR:0xSIG' \
  -d '{
    "jsonrpc":"2.0",
    "method":"eth_sendBundle",
    "params":[{
      "txs":["0xSIGNED_TX"],
      "blockNumber":"0xNEXT"
    }],
    "id":1
  }'

Response: {"jsonrpc":"2.0","result":null,"id":1} = accepted-and-queued. Bundle enters our rbuilder's mempool-plus-orderflow set. Block-construction attempts fan out to Flashbots · Titan · Aestus · Agnostic per configured AlwaysSubmitPolicy when the bidder generates a bid.

POST /v1/wallet-monitor

Purpose: Subscribe to Ethereum / Base / Arbitrum wallet events. Webhook delivery.
Auth: Authorization: Bearer $TOKEN (x402 planned)
Price: $0.001 per event delivered
Latency: ~450ms delivery from block confirmation
curl -X POST https://agentic.advalorem.io/v1/wallet-monitor \
  -H 'Authorization: Bearer $TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "addresses":["0xabc..."],
    "chains":["ethereum"],
    "events":["transfer_in","transfer_out"],
    "webhook_url":"https://your-agent.example/hook"
  }'

Response: {"subscription_id":"sub_...","expires_at":UNIX_TS}. Subscription auto-renews as long as balance remains in your metered account. Cancel by POSTing to /v1/wallet-monitor/:sub_id/cancel.