AUTONPAD / DOCUMENTATION

Give agents useful work.

Autonpad is a marketplace of paid APIs and workflows on Robinhood Chain. Developers publish JSON endpoints. Agents inspect the price and authorize a USDG payment through x402.

Call an API

Send a JSON input to an endpoint. An unpaid call returns HTTP 402 and a PAYMENT-REQUIRED header. Its terms include the token, exact amount, recipient, quote ID and input fingerprint.

curl -i 'https://YOUR_HOST/x/token-snapshot' \
  -H 'Content-Type: application/json' \
  --data '{"token":"0xe83c85e1ead16fcfe85401e2b337fb4fb5b5cc96"}'

Use the bundled CLI to inspect or pay. Set BUYER_PAY_TO to this instance’s trusted treasury address and BUYER_PRIVATE_KEY on the buyer machine. A saved authorization file allows retries without signing a new purchase.

npm run cli -- inspect https://YOUR_HOST token-snapshot input.json
npm run cli -- pay https://YOUR_HOST token-snapshot input.json request.payment
npm run cli -- resume request.payment

The TypeScript/JavaScript client and Python client are included in the source package. MCP exposes find_apis, get_quote, call_api, get_execution, and verify_receipt. Spend limits are checked by the client before signing.

Publish your API

Sign in, verify your payout wallet, and open Provider Studio. Enter an HTTPS endpoint, an object input schema, a JSON example, and a USDG price. GET inputs become query parameters. POST inputs become a JSON body.

Authentication headers are encrypted in storage and added by the gateway. Save a draft, test the saved endpoint, and request a listing. An administrator reviews public listings. Editing an approved API returns it to draft so the updated behavior can be reviewed.

Enable workflow use to let publishers include your API at its listed price. Quote snapshots preserve the provider, price, input schema, and payout destination agreed for that execution.

Compose workflows

A workflow contains up to eight steps. Each step selects a published API, gives it a unique key, and maps input fields from the buyer or an earlier step.

{
  "token": "$input.token",
  "creator": "$step.snapshot.market.creator"
}

Independent steps run in groups of up to three. Required steps must succeed before settlement. Optional failures are recorded in the fixed-price report. Workflow pricing covers its listed steps and the publisher’s margin.

On an interrupted POST, recovery depends on the upstream provider’s Idempotency-Key support. Providers declare this when registering. Execution state is retained in PostgreSQL.

Payment and payouts

Autonpad uses x402 exact payments in USDG on Robinhood Chain. The buyer signs an EIP-3009 authorization. The facilitator submits the transfer and pays ETH gas. This build supports EOA signatures.

Successful reports settle to the configured Autonpad treasury. Provider shares are recorded after a matching on-chain receipt. The configured platform fee is shown in the catalog flow and provider dashboard. Workflow step providers accrue their shares for successful steps. The workflow publisher accrues the package remainder after step allocations.

Accrued, reserved, and transferred balances are shown separately. Automatic payout requires a dedicated treasury signer, ETH for its gas, and an enabled payout worker. The payout minimum is configured by the operator. Each quote captures its payout destination, so changing a wallet affects future quotes.

Settlement can remain pending after an RPC timeout. Reuse the saved authorization or query the quote’s status with its bearer token. Failed required work is left uncharged by Autonpad. Operator costs already incurred by an upstream remain part of operating costs.

Inspect and verify receipts

Download the report bundle from a completed paid execution. It contains report, manifest, and receipt. The signed payload includes the quote, input fingerprint, report hash, manifest hash, network, amount, payer, recipient and transaction hash.

The verifier checks the signature against the configured receipt signer and recomputes both hashes. The public blockchain transaction can be inspected separately. Keep a downloaded bundle and the trusted signer address for independent verification.

Receive webhook events

Add an HTTPS destination in Settings and save its signing secret. Paid execution events include an event ID, type, execution ID, service, amount and payment transaction reference.

import { createHmac, timingSafeEqual } from 'node:crypto';

const signed = timestamp + '.' + rawRequestBody;
const expected = createHmac('sha256', webhookSecret)
  .update(signed).digest('hex');
// Require a fresh timestamp, compare the v1 signature in
// constant time, and deduplicate by Autonpad-Event-Id.

Delivery includes Autonpad-Timestamp, Autonpad-Signature and Autonpad-Event-Id. Retries preserve the event ID. A destination should acknowledge quickly and deduplicate the event before applying side effects.

Public RPC first

Every available RPC method starts on the configured public Robinhood endpoint. Alchemy paths are attempted after an unavailable connection, rate limit, unsupported method, or historical data restriction. A short capability cooldown reduces repeated failed calls.

Valid empty responses and contract business reverts remain valid outcomes. Every endpoint is checked for the configured chain ID. The admin view exposes routing counters by provider label and keeps credential-bearing URLs private.