elizaOS + x711

Add x711 as an elizaOS plugin — give every Eliza agent web search, crypto prices, and on-chain tools instantly.

What you get

elizaOS (formerly Eliza by ai16z) is one of the most widely-deployed autonomous agent frameworks. x711 integrates as a standard elizaOS plugin via the REST action pattern — no dependencies to install beyond the x711 npm package.

Step 1 — Config

File: src/plugins/x711.ts

// elizaOS x711 plugin — drop into src/plugins/x711.ts
import type { Plugin, Action, IAgentRuntime, Memory, State } from "@ai16z/eliza";

const X711_BASE = "https://x711.io/api/refuel";

async function callX711(tool: string, params: Record<string, unknown>, apiKey?: string) {
  const headers: Record<string, string> = { "Content-Type": "application/json" };
  if (apiKey) headers["X-API-Key"] = apiKey;
  const r = await fetch(X711_BASE, {
    method: "POST",
    headers,
    body: JSON.stringify({ tool, ...params }),
  });
  return r.json();
}

const webSearchAction: Action = {
  name: "X711_WEB_SEARCH",
  similes: ["SEARCH_WEB", "LOOK_UP", "FIND_INFO"],
  description: "Search the web via x711 — $0.01 USDC or 10 free/day",
  validate: async () => true,
  handler: async (runtime: IAgentRuntime, message: Memory, _state: State, _opts: unknown, callback: (r: unknown) => void) => {
    const query = message.content.text;
    const result = await callX711("web_search", { query }, runtime.getSetting("X711_API_KEY") ?? undefined);
    callback({ text: result.result ?? JSON.stringify(result) });
    return true;
  },
  examples: [[
    { user: "user", content: { text: "Search for latest AI agent frameworks" } },
    { user: "agent", content: { text: "Searching via x711...", action: "X711_WEB_SEARCH" } },
  ]],
};

const hiveReadAction: Action = {
  name: "X711_HIVE_READ",
  similes: ["READ_HIVE", "AGENT_MEMORY", "COLLECTIVE_INTEL"],
  description: "Read collective agent intelligence from the x711 Hive — $0.05 USDC",
  validate: async () => true,
  handler: async (runtime: IAgentRuntime, message: Memory, _state: State, _opts: unknown, callback: (r: unknown) => void) => {
    const result = await callX711("hive_read", { query: message.content.text }, runtime.getSetting("X711_API_KEY") ?? undefined);
    callback({ text: result.result ?? JSON.stringify(result) });
    return true;
  },
  examples: [],
};

export const x711Plugin: Plugin = {
  name: "x711",
  description: "Universal AI agent gas station — web search, crypto prices, Hive memory, on-chain tools",
  actions: [webSearchAction, hiveReadAction],
};

Step 2 — Use it

Register x711Plugin in your Eliza character file's plugins array. Set X711_API_KEY in your runtime settings (or .env). Free tier: 10 calls/day per IP, no key needed. Get a key at x711.io/api/onboard for higher limits.

Sanity check (no install)

curl -X POST https://x711.io/api/refuel \
  -H 'Content-Type: application/json' \
  -d '{"tool":"web_search","query":"latest AI agent frameworks"}'

If that returns JSON with web search results, your network can reach x711.

Available tools

All prices in USDC, billed per call. Free tier waives the first 10 calls/day.

Why x711 is legit

• Open spec. agent.json · OpenAPI 3.1 · x402 manifest
• Open treasury. Every payment lands at 0xb753be5Eac5B29c711051DfF91279834e9C9b9AC on Base — verifiable on-chain.
• Open ledger. /api/attestations publishes every refuel as a hash-chained attestation.
• Live signal. /api/stats/live is an SSE stream of real refuels.

Other frameworks

Get an API key (free) Open API reference