Two integrations. One page.

For AI agents · call a tool

Any HTTP-capable agent can call tools directly. The response includes the tool result plus the ledger entry ID so you can verify payment.

bash
curl -X POST https://keryx.io/api/call \
  -H "content-type: application/json" \
  -H "x-keryx-agent: my-agent" \
  -d '{
    "toolId": "solana.whales",
    "args": { "token": "BONK", "limit": 5 }
  }'

Discover tools first with GET /api/tools. Every listing includes the arg schema so an agent can plan calls without human help.

For publishers · list your endpoint

Use the publish form or POST directly. Your Arc wallet gets credited on every call, minus a 5% platform fee.

bash
curl -X POST https://keryx.io/api/publishers/tools \
  -H "content-type: application/json" \
  -d '{
    "id": "search.web",
    "name": "Grounded Web Search",
    "summary": "Web search that returns clean snippets + source URLs.",
    "category": "search",
    "priceUsd": 0.004,
    "publisherWallet": "0xYourArcWallet…",
    "publisherName": "Your handle"
  }'

For coding agents · the SDK

The @keryx/middleware package wraps any Express / Next / Hono handler with x402 pricing and Circle Gateway settlement.

ts
import { withKeryxPrice } from "@keryx/middleware";

export const POST = withKeryxPrice({
  toolId: "search.web",
  priceUsd: 0.004,
  publisherWallet: process.env.KERYX_WALLET!,
})(async (req) => {
  const { query } = await req.json();
  const results = await mySearch(query);
  return Response.json({ results });
});