Guide
Use Autonomo from your terminal
The Autonomo CLI is one command that finds an API on Autonomo, pays for the call on Robinhood Chain and prints the answer. There's nothing to install and no code to write, and looking around is free. It's part of the SDK's npm package, so the same spending limits apply.
Try it free
You need Node.js 20 or newer. These two commands cost nothing and need no wallet: the first searches the APIs, the second shows what a Risk Checker call would cost.
npx autonomo-sdk find "wallet holdings"
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49 --dry-runRisk Checker (token-risk)
https://autonomo.fun/x/token-risk/risk/0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49
0.01 USDG
100 AUTONOMO
0.010667 USDG private, through GloamPut a search of more than one word in quotes. --dry-run works on every command that pays.
Pay for a call
01Make a wallet for the agent
Create a new wallet just for this, and send it a little USDG or $AUTONOMO on Robinhood Chain. Keep only what it may spend in it. Paying in $AUTONOMO also needs a little ETH once, for a one-time approval.
02Set its key
The key is read only from AUTONOMO_WALLET_KEY. It's never taken as a flag, so it stays out of your shell history.
# macOS and Linux
export AUTONOMO_WALLET_KEY=0x…
# Windows PowerShell
$env:AUTONOMO_WALLET_KEY = "0x…"03Run a command
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49At a terminal it shows the price and asks before paying. Then it prints the answer and a receipt:
Risk Checker costs 0.01 USDG or 100 AUTONOMO. Pay from 0x…? [y/N] y
{ "token": "0x86b5…", "risk": { "level": "low", … }, … }
Paid 0.01 USDG to Risk Checker. Today: 0.01 of 1 USDG.
https://robinhoodchain.blockscout.com/tx/0x…Commands
| find [words] [input] | List APIs, best matches first. Free |
| quote <words> [input] | The API a call would use, and its prices. Free |
| call <words> [input] | Find the right API, pay for one call, print the answer |
| spend | Today's spending against your limits. Free |
| price [token] | $AUTONOMO's price, or any launchpad token's |
| launches [how many] | Newest token launches |
| risk <token> | Rug-risk check |
| tx <hash> | A transaction in plain words |
| portfolio <wallet> | What a wallet holds |
| read <https link> | A web page's text |
| offers <what you need> | Matching offers on Ostrapad |
The last seven are shortcuts for the official APIs. For any other API, say what you need with call, or name the API yourself with --slug and --path:
npx autonomo-sdk call "explain this transaction" 0x…
npx autonomo-sdk call --slug token-risk --path /risk/0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49call picks the API from your words, so check its choice with quote or --dry-run first. At a terminal the question before paying names the API too.
Options
| --dry-run | Show the price instead of paying |
| --yes | Don't ask before paying |
| --json | One object on stdout: the answer and the receipt |
| --max <usdg> | Most to pay for one call. Default 0.05 |
| --daily <usdg> | Most to spend per UTC day. Default 1 |
| --max-autonomo, --daily-autonomo | The same two limits in $AUTONOMO. Defaults 5,000 and 10,000 |
| --pay-with <token> | usdg, autonomo or auto. Default: USDG, then $AUTONOMO |
| --private | Pay from your private Gloam balance |
| --retry-header <header> | With --private: finish a call that was paid but not answered |
| --borro <credit line> | Borrow from this Borro line when the wallet is short of USDG |
| --slug <api> --path <path> | With call or quote: use this API and path, skipping the search |
| --help, --version | Every option and exit code, and the version |
Limits
Two limits are checked before anything is signed: the most for one call, and the most per UTC day. A call over either is refused, not paid. Today's spending is kept in ~/.autonomo/spend.json, shared with the SDK on the same machine.
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49 --max 0.02 --daily 0.5
npx autonomo-sdk spendPay privately with Gloam
Every official API also takes a payment from a private Gloam balance, so the payment doesn't link back to your wallet. Add --private and the command starts Gloam's own server, @gloamtrade/mcp, on your machine for that one payment and stops it afterwards.
01Give Gloam its own key and limits
Put these in ~/.gloam/agent.env and keep the file private. GLOAM_AGENT_PRIVATE_KEY is the key Gloam spends with. The Autonomo command never reads it, and Gloam's server is never given AUTONOMO_WALLET_KEY.
GLOAM_NETWORK=robinhood-mainnet
GLOAM_AGENT_PRIVATE_KEY=0x…
GLOAM_LIMIT_NETWORK=robinhood-mainnet
GLOAM_LIMIT_ASSETS=USDG
GLOAM_LIMIT_MAX_PER_PAYMENT=0.05
GLOAM_LIMIT_MAX_PER_DAY=1
GLOAM_LIMIT_RECIPIENTS=any02Deposit USDG into its private balance
Gloam pays from a private balance, not from a wallet. The SDK guide shows how to move USDG in and check it: see Pay privately with Gloam.
03Pay
No AUTONOMO_WALLET_KEY is needed. The first line shows the private price, the second pays it:
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49 --private --dry-run
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49 --private- The price includes Gloam's fee and counts against
--maxand--dailyas USDG. - It can take a few minutes, because Gloam builds the payment's proofs on your machine.
- It can't be combined with
--pay-withor--borro. - Paid but no answer? The error prints a payment header. Don't run the command again as it was: add the header, and you get the answer without paying twice.
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49 --private --retry-header <header>Pay on Borro credit
With a Borro credit line, the command borrows just what the wallet is short of and pays in the same call. Pass the credit line's address, or set it once in AUTONOMO_BORRO_ACCOUNT. AUTONOMO_WALLET_KEY is the agent wallet set on that line.
npx autonomo-sdk risk 0x86b57bcb9d249cf096cf8e21426c9dc9cafdec49 --borro 0x…Borrowed payments count against the USDG limits like any other.
For scripts and agents
Claude Code, Codex, Cursor and any other agent that runs shell commands can use the CLI with no setup beyond the wallet key. Outside a terminal it never asks a question, so nothing hangs.
# The answer is on stdout, so it pipes. The receipt goes to stderr.
npx autonomo-sdk price --yes | jq .
# One object with both, for an agent to read.
npx autonomo-sdk launches 5 --jsonEach way a call can end has its own exit code:
| 0 | Done |
| 1 | Failed for another reason |
| 2 | Bad usage |
| 3 | Over a limit, so not paid |
| 4 | Can't pay: no wallet, an empty one, or Gloam isn't set up |
| 5 | The payment was refused, or was paid without an answer |
| 6 | No such API |
With --json, an error is one object on stderr: { "error": { "code", "message" } }.
Good to know
- The package is
autonomo-sdk.npx autonomois someone else's package. Afternpm install -g autonomo-sdkthe command is justautonomo. - It only pays Autonomo's gateways, on Robinhood Chain, in USDG or $AUTONOMO.
- A wallet payment only settles after the API answers, so a call it fails to answer isn't charged. A private payment is made first; that's what
--retry-headeris for. - Writing code instead? The same calls are one function in the SDK for TypeScript and Python. For AI apps, see the MCP server.