IBIT · iShares Bitcoin Trust ETF

Terminal · see the 402

curl -i "https://osd.x402jp.com/api/solana-stocks/IBIT?view=full"

Answers HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON: network solana:5eykt4…, asset USDC, amount 1000). The free view is the same URL without ?view=full.

x402 client · pay and read

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

const signer = await createKeyPairSignerFromBytes(secretKey); // a wallet holding USDC
const client = new x402Client();
registerExactSvmScheme(client, { signer });
const http = new x402HTTPClient(client);

const url = "https://osd.x402jp.com/api/solana-stocks/IBIT?view=full";
const challenge = await fetch(url);                       // 402
const required = http.getPaymentRequiredResponse(
  (h) => challenge.headers.get(h),
);
const payment = await http.createPaymentPayload(required); // signs a USDC transfer
const res = await fetch(url, { headers: http.encodePaymentSignatureHeader(payment) });
console.log(await res.json());                            // 200 + full record

Gas is sponsored by the facilitator — the wallet needs USDC, not SOL. Discovery: /.well-known/x402.json

MCP · free view

claude mcp add --transport http onchain-stock-data https://osd.x402jp.com/api/mcp

Then call the read-only tool:

solana_stock_get({ "ticker": "IBIT" })

Returns the free view — tokens and mints, next earnings (primary source only), condition counts, latest verdict, and the per-call URL above. MCP reads are free; the full record is the HTTP endpoint. Fields: /docs

Free JSON

curl "https://osd.x402jp.com/api/solana-stocks/IBIT"