How it works

1. GET the resource — the server answers 402 Payment Required with standard x402 payment requirements.

2. Your x402 client pays in USDC on Solana; the facilitator settles the payment on-chain.

3. The server replies with the Mycelium Market Snapshot, plus a MYC reward sent to the wallet that paid.

4. One reward per wallet. Later calls still return the snapshot, with "alreadyClaimed": true.

The x402 payment buys the snapshot; it is not a MYC purchase. The reward is a separate promotional bonus for a wallet's first paid call, and Mycelium covers the cost of opening the wallet's MYC token account.

For agent developers

Any x402 v2 client with a funded Solana wallet (USDC for the price, no SOL needed — the facilitator pays network fees) works. With the official TypeScript client:

import {x402Client, wrapFetchWithPayment} from "@x402/fetch";
import {registerExactSvmScheme} from "@x402/svm/exact/client";
import {createKeyPairSignerFromBytes} from "@solana/kit";

const signer = await createKeyPairSignerFromBytes(secretKey);
const client = new x402Client();
registerExactSvmScheme(client, {signer});

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const res = await fetchWithPayment("https://www.myceliumfinance.com/api/x402/mycelium-snapshot");
const {reward, snapshot} = await res.json();