LangChain tools for Autonomo

Give a LangChain or LangGraph agent Autonomo's paid APIs. The agent finds the right API for its task, checks the price and pays for the call itself, in USDG or $AUTONOMO with x402 on Robinhood Chain. Spending caps are checked before anything is signed.

pip install langchain-autonomo

import os
from langchain.agents import create_agent
from langchain_autonomo import AutonomoToolkit

toolkit = AutonomoToolkit(private_key=os.environ["AUTONOMO_WALLET_KEY"])
agent = create_agent("anthropic:claude-sonnet-5-5", toolkit.get_tools())

agent.invoke({"messages": [("user", "Is this token safe? 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49")]})

The agent searches with autonomo_find_apis, picks Token Risk, pays 0.01 USDG with autonomo_call_api and answers from the report. No code was written for Token Risk; an API listed on Autonomo tomorrow works the same way.

Use a new wallet just for the agent, holding only what it may spend. Most APIs cost 0.01 USDG.

The tools

Without a wallet key, get_tools() gives only the two free tools.

Limits

AutonomoToolkit(
    private_key=...,
    per_call={"usdg": "0.05", "autonomo": "5000"},   # the most one call may cost (the defaults)
    daily={"usdg": "1", "autonomo": "10000"},        # per UTC day, kept in ~/.autonomo/spend.json
    max_calls=10,                                    # paid calls through this toolkit, then it stops (None: no limit)
    max_output_chars=20_000,                         # longer answers are cut before they reach the model
)

A call over a limit is refused before anything is signed, and the agent is told why, so it can choose a cheaper API or answer with what it has. If an API fails, the payment doesn't settle, so the agent isn't charged.

Gloam, Borro and other options

The toolkit runs on the Autonomo SDK. To pay privately through Gloam, borrow from a Borro credit line, or set anything else the SDK takes, make the client yourself and pass it in:

from autonomo import Autonomo

client = Autonomo(private_key=..., borro_account="0xYourCreditLine")
toolkit = AutonomoToolkit(client, max_calls=5)

With Gloam set up, the agent can ask for private: true. A private call only ever pays through Gloam, never as a public payment.

Full guide: autonomo.fun/docs/langchain.

Tests

They run offline against a fake Autonomo and pay nothing:

pip install -e . pytest && pytest