Pay per call · USDC on Solana or USDG for Robinhood Chain data · Compare plans and subscribe
Research token holders, bundle exposure and top traders with x402
Build a wallet-funded research agent for Solana and Robinhood Chain. Select the holder and bundle routes, budget each request and interpret trader profit and missing evidence.
By MadeOnSol · Updated
Integration choice
Start with one token and the question you need to answer. Request a wallet profile only after the trader ranking identifies a wallet of interest. A KOL purchase alone tells you neither who owns the supply now nor how much a bundle still holds.
Before you start
- A token address and its data chain. Discovery and the first HTTP 402 challenge are free.
- For a paid call, use an x402 client with an independently pinned merchant and fee payer and a bounded authorization budget. The MadeOnSol SDKs and MCP server do not cover these five routes yet; call them over HTTP as in the example below until a package release adds them.
Implementation steps
- Choose the data chain and look up its catalog. A Solana mint uses base58. A Robinhood Chain token uses its 0x address even if the agent pays in Solana USDC.
- After a KOL buy, read holders and bundle-share for the same token. Keep the source, window and observation time with each result.
- On Robinhood Chain, request top-traders when you need a ranking. Use the returned trader address for the wallet lookup. Inspect the FIFO and pnl_coverage fields before interpreting a profit figure.
- Read the unpaid 402 challenge before signing. Select one supported asset and check the preconfigured merchant, network, per-call ceiling and remaining budget. Never re-sign a paid call automatically after a timeout.
What do two reads cost?
At the catalog prices in this release, holders plus bundle-share costs 0.04 USDC for either data chain. Paying natively on Robinhood Chain costs 0.08 USDG for those two reads. Adding RHC top traders and one wallet profile brings the four-read total to 0.065 USDC or 0.16 USDG. Use the actual challenge for the final price.
Interpret owners and bundle evidence
The Solana cap table describes early buyers. Holders ranks current owners. Read the holder response’s denominator before comparing concentration with a bundle share of total supply. Preserve the raw balances as strings.
Solana returns a broad same-slot estimate and a strict linked-wallet share. Robinhood Chain supplies the broad same-block estimate. Its strict share is null. Inspect as_of and completeness before reporting the figure.
Follow the result to one wallet
RHC top-traders ranks by net ETH flow. A wallet can still hold an open position. Use FIFO realized profit and its coverage on the trader row, then fetch the wallet profile for observed activity. Keep an unknown cost basis or identity label unknown. A wallet with no observed activity returns HTTP 404 as a final paid result. The wallet-profile lookup still costs 0.005 USDC on Solana or 0.04 USDG on Robinhood Chain at these catalog prices.
Code examples
Read catalog prices without a wallet (shell)
curl -fsS https://madeonsol.com/api/x402
curl -fsS https://madeonsol.com/api/x402/rhcInspect a holder offer (Node.js; sends no payment)
const mint = process.env.SOLANA_MINT;
if (!mint) throw new Error("Set SOLANA_MINT to the token address");
const url = new URL("https://madeonsol.com/api/x402/tokens/" + encodeURIComponent(mint) + "/holders");
url.searchParams.set("source", "index");
const response = await fetch(url);
if (response.status !== 402) throw new Error("Expected HTTP 402, got " + response.status);
const challenge = await response.json();
for (const { network, asset, amount } of challenge.accepts) {
console.log({ network, asset, amountAtomic: amount });
}Pay for one holder read over HTTP (Node.js, public x402 packages)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactSvmScheme } from "@x402/svm/exact/client";
import { createKeyPairSignerFromBytes } from "@solana/kit";
import { base58 } from "@scure/base";
// Pin the merchant and fee payer independently of any 402 challenge.
const { SVM_PRIVATE_KEY, SVM_RPC_URL, X402_PAY_TO, X402_FEE_PAYER, SOLANA_MINT } = process.env;
const SOLANA = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
const USDC = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
const MAX_ATOMIC = 20000n; // one $0.02 call
const signer = await createKeyPairSignerFromBytes(base58.decode(SVM_PRIVATE_KEY));
const client = new x402Client()
.register(SOLANA, new ExactSvmScheme(signer, { rpcUrl: SVM_RPC_URL }))
.registerPolicy((_version, offers) => offers.filter(o =>
o.network === SOLANA && o.asset === USDC && o.payTo === X402_PAY_TO &&
o.extra?.feePayer === X402_FEE_PAYER && BigInt(o.amount) <= MAX_ATOMIC));
const paidFetch = wrapFetchWithPayment(fetch, client);
// Robinhood Chain routes take a 0x token address and accept this same USDC offer.
const url = new URL("https://madeonsol.com/api/x402/tokens/" + encodeURIComponent(SOLANA_MINT) + "/holders");
url.searchParams.set("source", "index");
const response = await paidFetch(url); // signs at most one payment
if (!response.ok) throw new Error("HTTP " + response.status + "; do not repeat a paid call automatically");
const holders = await response.json();
console.log(holders.source?.method, holders.as_of, holders.holders.length);Interpret an illustrative RHC bundle response fragment (JSON)
{
"chain": "robinhood",
"bundled_pct_basis": "same_block_heuristic",
"bundled_pct_of_supply_now": 0.00003,
"strict_bundle_pct_of_supply_now": null,
"wallets": { "holding": 3 }
}Common mistakes and fixes
| Mistake | Recommended fix |
|---|---|
| An agent reports that all bundlers exited because the display rounds to 0.00%. | Retain the raw fraction, wallet count and coverage until presentation. Inspect wallets.holding before drawing an exit conclusion. |
| A client reauthorizes a call after a network timeout. | Do not repeat a timed-out paid call automatically. The generic HTTP client in the example has no paid-result recovery, so keep the first payment response and identifier and contact support instead of paying twice. MadeOnSol clients recover a lost result with the original proof once they support these routes. |
Verify your integration
Run discovery and an unpaid request first. Check that the expected asset, amount and network appear together. Test that missing strict evidence remains null, a small nonzero share keeps its precision and a credit-limited agent stops before a second authorization.
Production checklist
- Verify both RHC payment options in discovery and the chosen challenge.
- Record paid proof, observation time and coverage separately.
- Test unavailable, measured zero and a small positive share independently.
Frequently asked questions
Do I need a funded wallet to inspect prices?
No. Both discovery catalogs and the unpaid HTTP 402 challenge can be read without signing.
Can one client use every advertised payment option?
The endpoint advertises the supported options; a client signs only the assets it supports. The currently published Robinhood Chain SDKs do not yet sign for the three new Robinhood Chain routes. Pay their USDC-on-Solana option over HTTP with the example until an SDK release lists them.
