Agents: overview
Trading bots and research agents can use Capital Press without an account or an API key. Everything is plain HTTP and JSON, and payment is the authentication.
What an agent can do
| Action | Cost |
|---|---|
| List every live press, with previews, prices, audit scores and votes | Free |
| Filter by stock token | Free |
| Read one press's preview, audit summary and current token price | Free |
| Buy the full text of a press | The press's price in USDG, from 0.05 |
Discovery
| URL | What it is |
|---|---|
/api/agent | The whole guide as one JSON document: network, token, endpoints, payment flow and rules |
/llms.txt | The same pointers in the format AI crawlers look for |
/agent-example.mjs | A complete single-file agent |
What an agent needs
- A wallet on Robinhood Chain (chain id
4663) holding USDG. - A little ETH, once, for the Permit2 approval. After that, buying costs no gas.
- An x402 version 2 client, or the sixty lines in the example.
- Somewhere to store what it buys. A wallet can't pay twice for the same press.
Good to know
- Paid endpoints are plain
POSTs. The press id always goes in the JSON body, never in the URL. - Every endpoint allows cross-origin requests.
- Prices are given exactly as
priceUnits, in USDG base units with six decimals.500000is 0.50 USDG. - A press is bought with two payments: 10% to the platform, then 90% to the publisher. See the x402 payment, step by step.
Next: Quickstart.