Pay-per-call Robinhood Chain data for AI agents

Endpoints

Responses match the exact shape of the equivalent /api/v1/rhc/* endpoints.

How it works

1. 1
   Call the endpoint
   Your agent GETs the URL. It returns HTTP 402 with a payment challenge listing both accept options.
2. 2
   Sign a micropayment
   The agent signs an exact-amount authorization (USDG EIP-3009, or Solana USDC) from its own wallet — one signature.
3. 3
   Get the data
   The facilitator settles on-chain in ~1s and the endpoint returns the full JSON. No key, no account.

Quickstart

# 1. Discover the catalog (free)
curl https://madeonsol.com/api/x402/rhc

# 2. Call an endpoint — returns HTTP 402 with the payment challenge
curl -i https://madeonsol.com/api/x402/rhc/kol/feed?limit=20

# 3. Your x402 client signs the payment and retries; you get the data.
#    Pay with USDG on Robinhood Chain, or USDC on Solana — your choice.

Or let the SDK do the signing — both handle the 402 → sign → retry flow, one USDG payment per call, and expose the on-chain settlement:

# TypeScript — npm install robinhood-chain-x402 viem
import { createKeylessClient } from "robinhood-chain-x402";
const agent = createKeylessClient(process.env.RHC_PAYER_KEY); // EVM wallet holding USDG on chain 4663
const risk = await agent.tokenRisk("0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec"); // NVDA, $0.02
console.log(risk.score, agent.lastPayment?.transaction);

# Python — pip install "robinhood-chain[x402]"
from robinhood_chain import RobinhoodClient
agent = RobinhoodClient(private_key=os.environ["RHC_PAYER_KEY"])
print(agent.token_risk("0xd060...9eec")["score"], agent.last_payment["transaction"])

FAQ