x402 · USDC on Base or Solana

x402-markets

Crypto spot prices from CoinGecko and parsed SEC EDGAR filings, one paid lookup at a time. $0.001 for a price snapshot, $0.003 for a company's recent filings — decoded, summarized, and linked. No API key, no account, no subscription.

git clone https://github.com/nirholas/x402-markets
cd x402-markets && npm install
npm run dev

Pricing

RoutePriceReturns
GET /price/:coinId$0.001 Spot price, 1h/24h/7d change, 24h high–low range, volume, market cap, supply, and distance from all-time high and low
GET /filings/:ticker$0.003 Company identity (CIK, SIC, exchanges) plus recent filings with form, dates, direct document link, decoded 8-K items, and a plain-English summary
GET /, GET /health, GET /.well-known/x402 freeService info, liveness, discovery manifest

Every paid route returns the purchased artifact in the 200 response body.

Two rails, one price

The 402 challenge advertises both. Your client picks whichever it can sign.

USDC on Base

network base-sepolia · base on mainnet
0x40252CFDF8B20Ed757D61ff157719F33Ec332402

USDC on Solana

network solana · solana-devnet on devnet
WwwuGbqHrwF5RG89KhUbmRWEvjnRH9k5kVM5p7T3WwW

How a paid call works

1 · 402 2 · Sign 3 · Settle 4 · 200 Server quotes both rails Client signs Base or Solana Facilitator verifies on-chain Artifact in the body + receipt

Quickstart (agent side)

import { wrapFetchWithPayment, createSigner } from "x402-fetch";

const signer = await createSigner("base-sepolia", process.env.PRIVATE_KEY!);
const payFetch = wrapFetchWithPayment(fetch, signer);

const res = await payFetch(
  "http://localhost:4023/price/bitcoin"
);
const artifact = await res.json(); // purchased artifact, in-response

Links