nirium-agentic-payments

Nirium: charge AI agents and read live signals on Stellar

Nirium is an open-source toolkit for x402 agentic payments on Stellar: a TypeScript/Python SDK, a scaffolding CLI, and an MCP server. It is not a demo — the mainnet endpoint has been billing real USDC over x402 since 9 July 2026. A mainnet settlement from that day, verifiable on Stellar Expert: 3134a51c…7558bc.

Do this

1. Scaffold a paid API in one command

npm install -g nirium-cli
nirium create x402 --name my-paid-api
cd my-paid-api && npm install

Fill two values in the generated .env:

Variable	Where it comes from
STELLAR_PAY_TO	the Stellar account that receives payments (G...)
X402_FACILITATOR_API_KEY	free — keys are per network, and the scaffold defaults STELLAR_NETWORK to testnet: channels.openzeppelin.com/testnet/gen for testnet, channels.openzeppelin.com/gen for mainnet

The API key is not optional — the facilitator rejects unauthenticated servers on both testnet and mainnet, so without it your routes never get as far as offering a 402.

npm run dev

2. Charge per request with x402Serve()

The scaffolded server is about ten lines because x402Serve(), from the nirium SDK, carries the facilitator client, the scheme registration, and the route table:

import { x402Serve } from 'nirium';

app.use('/premium', x402Serve({
    payTo: 'G...',
    routes: { 'GET /signals': '$0.02' },
}));

A caller without payment gets a 402 carrying the terms; one that pays gets the data, and the USDC transfer settles on Stellar before your handler returns. No subscription, no card, no invoice, no human in the middle. This is the exact pattern Nirium's own mainnet endpoint runs in production against real callers — see the devlog for a real incident (and its fix) from operating it at scale: docs/devlog.md.