# Autonomo

> Autonomo is the agentic x402 launchpad and directory. API creators put a price on an API and AI agents pay for each call over x402, in USDG or $AUTONOMO on Robinhood Chain, with no API keys or accounts: just a wallet. Autonomo also lists x402 APIs from across the ecosystem and runs its own official APIs for Robinhood Chain.

Key facts:

- Chain: Robinhood Chain, chain ID 4663 (x402 network `eip155:4663`). Explorer: https://robinhoodchain.blockscout.com
- $AUTONOMO contract: `0xe83c85e1ead16fcfe85401e2b337fb4fb5b5cc96` (18 decimals). This is the only official address.
- Each hosted gateway takes USDG, $AUTONOMO or both, as its creator chooses; the prices below show which. Self-hosted APIs in the directory use whatever their own facilitator supports, most often USDC on Base.
- Autonomo's facilitator settles each gateway payment on-chain and pays the gas. Paying in $AUTONOMO needs a one-time Permit2 approval, which costs a little ETH.
- 5% of every payment through a hosted gateway buys back and burns $AUTONOMO. Every burn is listed at https://autonomo.fun/burn.
- The discovery API is free JSON, with no key and open CORS.

## Call an API

1. Find one: `GET https://autonomo.fun/api/v1/gateways` lists every live Autonomo gateway with its URL, the path to append and its prices. `GET https://autonomo.fun/api/v1/projects?q=<search>` searches the whole x402 directory.
2. Call it: `GET https://autonomo.fun/x/<slug><path>`. Without a payment the gateway answers HTTP 402, with what it accepts in the `PAYMENT-REQUIRED` header (x402 version 2, scheme `exact`).
3. Pay: sign the payment with an x402 client (for example `@x402/fetch` with `@x402/evm`) and send the same request again with it in the `PAYMENT-SIGNATURE` header (`X-PAYMENT` also works). A call whose API fails is not charged.

Or use one of Autonomo's tools, which do all three steps within a per-call cap and a daily budget:

- MCP server (Claude, Cursor, Codex and other MCP clients): `npx -y autonomo-mcp` with `AUTONOMO_WALLET_KEY` set to a dedicated agent wallet. Tools: `find_apis` and `get_price` (free), `call_api` (pays). Guide: https://autonomo.fun/docs/agents#mcp
- SDK: `npm install autonomo-sdk` or `pip install autonomo-sdk`. One `call` finds the API, pays and returns the answer with a receipt. Guide: https://autonomo.fun/docs/sdk
- CLI: `npx autonomo-sdk find "<what you need>"`, then `npx autonomo-sdk call "<what you need>"`. Add `--dry-run` to see the price without paying. Guide: https://autonomo.fun/docs/cli
- LangChain and LangGraph: `pip install langchain-autonomo` or `npm install langchain-autonomo`. Guide: https://autonomo.fun/docs/langchain

Use a new wallet with a small balance for an agent, never a main wallet.

## Live APIs

Every API live on an Autonomo gateway right now, including Autonomo's official APIs for Robinhood Chain (see https://autonomo.fun/docs/official-apis). In paths, replace `<…>` with your value.

- [Token Price](https://autonomo.fun/projects/token-price): Live AUTONOMO-token price: USD and ETH price, an example of a working API. Call `GET https://autonomo.fun/x/token-price/price/autonomo`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [New Launches](https://autonomo.fun/projects/new-launches): Newest token launches on Robinhood Chain: name, age, buys, sells, market cap and bonding curve progress for each new token. Call `GET https://autonomo.fun/x/new-launches/launches?limit=10`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [Risk Checker](https://autonomo.fun/projects/risk-checker): Rug-risk check for Robinhood Chain launchpad tokens: is it safe? Holder concentration, creator holdings, launch-block buyers and bot volume, scored low/medium/high. Call `GET https://autonomo.fun/x/token-risk/risk/<token contract address>`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [Token Lookup](https://autonomo.fun/projects/token-lookup): Token price lookup: live price and market cap of any Robinhood Chain launchpad token by contract address. Call `GET https://autonomo.fun/x/token-lookup/price/<token contract address>`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [Tx Explainer](https://autonomo.fun/projects/tx-explainer): Transaction explainer: any Robinhood Chain transaction explained in plain English, with transfers and fee. Call `GET https://autonomo.fun/x/tx-explainer/tx/<transaction hash>`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [Wallet Portfolio](https://autonomo.fun/projects/wallet-portfolio): Wallet portfolio: what a Robinhood Chain wallet holds in USD, with warnings for impostor tokens. Call `GET https://autonomo.fun/x/wallet-portfolio/portfolio/<wallet address>`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [Page Reader](https://autonomo.fun/projects/page-reader): Page reader: read any public web page and get its title, description and clean text for agents. Call `GET https://autonomo.fun/x/page-reader/page?url=<url-encoded https:// link>`. Price per call: 100 $AUTONOMO or 0.01 USDG.
- [Ostrapad Offer Finder](https://autonomo.fun/projects/ostrapad-offer-finder): Find AI agents for hire on Ostrapad: say what you need done and get matching offers with their USDG price, delivery time, who judges the work and each provider's record. Built on Ostrapad's public listings; not an official Ostra API. Call `GET https://autonomo.fun/x/ostrapad-offer-finder/offers?q=<what you need done>`. Price per call: 100 $AUTONOMO or 0.01 USDG.

## Docs

- [Docs](https://autonomo.fun/docs): How Autonomo works: launch an API that AI agents pay for per call, use Autonomo's APIs from your agent, and how $AUTONOMO, the burn and Verified work.
- [Use Autonomo from your agent](https://autonomo.fun/docs/agents): Let Claude, Cursor, Codex or your own code find APIs on Autonomo and pay per call in USDG or $AUTONOMO, or try the Agent Playground and the Telegram bot.
- [Pay for APIs in one call with the SDK](https://autonomo.fun/docs/sdk): The Autonomo SDK for TypeScript and Python: one call finds the right API, pays in USDG or $AUTONOMO on Robinhood Chain, privately through Gloam or on Borro credit, within your limits, and returns a receipt.
- [Use Autonomo from your terminal](https://autonomo.fun/docs/cli): The Autonomo CLI: one command finds an x402 API, pays for the call in USDG or $AUTONOMO on Robinhood Chain, privately through Gloam or on Borro credit, within your limits, and prints the answer.
- [Use Autonomo from LangChain](https://autonomo.fun/docs/langchain): LangChain tools for Python and TypeScript: an agent finds the right Autonomo API for its task, checks the price and pays for the call in USDG or $AUTONOMO on Robinhood Chain, within your limits.
- [Official APIs](https://autonomo.fun/docs/official-apis): The APIs Autonomo runs for Robinhood Chain: token prices, new launches, rug-risk checks, transactions, wallets, web pages and agents for hire on Ostrapad, payable per call in USDG or $AUTONOMO.
- [API](https://autonomo.fun/api-docs): Free JSON API for agents to discover x402 APIs and Autonomo gateways.
- [Pay privately with Gloam](https://autonomo.fun/docs/gloam): Pay any API on Autonomo that accepts USDG from a private Gloam balance on Robinhood Chain, so the payment doesn't link back to your wallet.
- [Pay with a Borro credit line](https://autonomo.fun/docs/borro): An agent with a Borro credit line can pay Autonomo APIs without holding USDG first: it borrows just what it's short and pays in the same request, on Robinhood Chain.
- [Use Autonomo from Ostra](https://autonomo.fun/docs/ostra): An agent with an Ostra vault can find Autonomo's APIs and pay for each call in USDG on Robinhood Chain, with Ostra's MCP server: autonomo_catalog lists them, pay calls them.
- [Launch an API from the dashboard](https://autonomo.fun/docs/launch): Step by step: put your API behind an Autonomo gateway, set a price per call, test it and get it listed so AI agents find it.
- [Run x402 on your own server](https://autonomo.fun/docs/self-hosted): Add x402 to your own API server, check that it answers 402, and get it listed on Autonomo.
- [Get paid at a Safe](https://autonomo.fun/docs/safe): Set up a Safe multisig on Robinhood Chain and have your Autonomo APIs pay it, while your own wallet keeps launching and managing them.
- [The x402 directory](https://autonomo.fun/docs/directory): What's in Autonomo's x402 directory, how to search it, what each project page shows, where the data comes from, and how to get your project listed or fixed.
- [$AUTONOMO, burn and Verified](https://autonomo.fun/docs/token): The official $AUTONOMO contract address, what the token pays for, how every paid API call burns it, and how holding it gets API providers a Verified badge.

## Discovery API

- `GET https://autonomo.fun/api/v1/gateways`: every live Autonomo gateway, with prices, the path to call, Verified status and track record.
- `GET https://autonomo.fun/api/v1/projects`: search the x402 directory. Parameters: `q`, `category`, `network`, `sort` (popular, relevance, new, price, name), `page`, `limit` (max 100).
- `GET https://autonomo.fun/api/v1/projects/{slug}`: one project with up to 500 of its paid endpoints.
- `GET https://autonomo.fun/api/v1/stats`: totals, counts per category and the most common networks.

## Optional

- [Agent Playground](https://autonomo.fun/playground): Ask about tokens, wallets and transactions on Robinhood Chain, or paste a token for a full research report, and watch an AI agent pay for the x402 APIs it needs in $AUTONOMO.
- [Numbers](https://autonomo.fun/numbers): Paid calls, refused payments, failures, payers and speed for each official Autonomo API.
- [Burn](https://autonomo.fun/burn): Every $AUTONOMO burn from paid API calls on Autonomo, with an on-chain receipt for each one.
- [Roadmap](https://autonomo.fun/roadmap): What Autonomo has shipped, what comes next, and what comes later for x402 APIs, agents and $AUTONOMO.
- [Partners](https://autonomo.fun/partners): The teams Autonomo works with, and what each partnership adds for API creators and agents.
- [Directory](https://autonomo.fun/projects): every x402 project Autonomo tracks, with live prices and usage.