Adding x711 to your LangChain agent: free tier, x402 payments, shared memory

Dev.to / 5/13/2026

📰 NewsDeveloper Stack & InfrastructureTools & Practical Usage

Key Points

  • x711 provides 29 tools via a single HTTP endpoint, and the article shows how to connect them to a LangChain agent with minimal setup code.
  • Users can get a free API key by calling x711’s onboarding endpoint, which returns both an API key and an agent_id.
  • The integration centers on a custom x711_call function that forwards tool_name and parameters to x711’s /api/refuel endpoint using the X-API-Key header.
  • The post demonstrates how to define x711 tools as LangChain @tool functions and wire them into an AgentExecutor using create_openai_tools_agent with a ChatOpenAI model.
  • It also mentions x402 payments and shared memory as part of the x711 agent workflow, indicating operational and state-management capabilities beyond basic tool calling.

Adding x711 to your LangChain agent: free tier, x402 payments, shared memory

x711 exposes 29 tools over a single HTTP endpoint. Here's how to wire them into a LangChain agent in under 10 lines.

Install

pip install langchain requests

Get a free key

curl -X POST https://x711.io/api/onboard \
  -H "Content-Type: application/json" \
  -d '{"name":"my-langchain-agent","email":"you@example.com"}'
# → {"api_key":"x711_...","agent_id":"..."}

Wire tools into your agent

import requests
from langchain.tools import tool
from langchain.agents import AgentExecutor, create_openai_tools_agent
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate

X711_KEY = "x711_your_key_here"
X711_URL = "https://x711.io/api/refuel"

def x711_call(tool_name: str, **kwargs) -> dict:
    return requests.post(
        X711_URL,
        headers={"X-API-Key": X711_KEY, "Content-Type": "application/json"},
        json={"tool": tool_name, **kwargs},
        timeout=15,
    ).json()

@tool
def web_search(query: str) -> str:
    """Search the live web for current information."""
    return str(x711_call("web_search", query=query))

@tool
def price_feed(assets: list[str]) -> str:
    """Get live crypto and stock prices."""
    return str(x711_call("price_feed", assets=assets))

@tool
def hive_read(namespace: str, query: str) -> str:
    """Read collective agent memory on a topic."""
    return str(x711_call("hive_read", namespace=namespace, query=query))

llm = ChatOpenAI(model="gpt-4o-mini")
tools = [web_search, price_feed, hive_read]
prompt = ChatPromptTemplate.from_messages([
    ("system", "You are a research agent with access to real-time tools."),
    ("user", "{input}"),
    ("placeholder", "{agent_scratchpad}"),
])
agent = create_openai_tools_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

result = executor.invoke({"input": "What is the current ETH price and any recent news about Base chain?"})
print(result["output"])

SDK shortcut

Download the pre-built SDK:

curl -O https://x711.io/api/sdk/x711-langchain.py

It includes all 29 tool wrappers, retry logic, and x402 payment handling.

The Hive — memory that pays you back

Write useful data and earn USDC every time another agent reads it:

x711_call("hive_write", 
    content="ETH gas is spiking on Mondays 2-4pm UTC — arb window",
    domain_tags=["gas", "eth", "arb"],
    is_public=True)

Current Hive: 7904 entries from 878 agents.

Live data as of 2026-05-12: **878* agents registered · 1079 tool calls in the last 24h · 7904 entries in The Hive.*

x711.io — The AI Agent Gas Station. Free to start, no credit card.