MARKET
Nirium← Home
Nirium Logo
GETTING STARTED

HOW TO OPERATE

What's actually real today: x402 pay-per-request, an opt-in Treasury rebalancer (self-funded test vault, invite-only while legal review is open), and Audit Trail receipts anyone can verify.

Step 1

Get an API key

Issue a free key for the Nirium agent - audit anchoring, reporting and authenticated endpoints. One key works on both testnet and mainnet. No wallet connection required to get started.

Free tier: 20 requests/min
Works on testnet and mainnet
No seed phrase needed to start
Higher tiers by invitation
Get a key
Step 2

Pay for an API call with x402

Charge or pay per request over HTTP 402. A seller returns a 402 challenge, the buyer signs a Stellar authorization entry, a facilitator verifies and settles on-chain. Nirium's own endpoint answers 402 on mainnet (last payment settled 29 Sep 2026); third-party sellers are supported on testnet.

Testnet: open to everyone
x402Serve() for sellers
Any x402 client works as a buyer
Settled on Stellar, verifiable on Horizon
See the quickstart
Step 3

Try the Treasury rebalancer

A Soroban contract that moves idle USDC into CETES (Mexican sovereign debt) via Etherfuse. The agent holds only the RebalanceManager role - it cannot withdraw funds, by contract. Today's live vault is our own team's, self-funded; real-client onboarding is invite-only while a specific legal question (LFPIORPI art. 17 fraction XVI, as Art. 24 Bis 4 of its General Rules defines it) stays under review.

4 real rebalances to date, all 6 Aug 2026
RebalanceManager role: no withdrawal, by contract
Self-funded test vault, invite-only for real clients
Read-only vault state via the live API
Open the builder
Step 4

Anchor and verify a receipt

Audit Trail hashes a record, anchors it to IPFS, and optionally signs it with your own Stellar key. Anyone can paste the resulting CID at /verify and check it independently, without trusting Nirium's backend.

Opt-in per call, not automatic logging
ed25519 signature, optional but recommended
Verifiable by anyone, no account needed
34 anchors on mainnet to date
Try /verify
Step 5

Pay a team with a Payouts batch

Send USDC to many recipients in one Stellar transaction. Nirium builds the batch unsigned; your company signs it with its own wallet, and only then is it sent - Nirium never holds the funds. Testnet is open; mainnet is invite-only and every run requires accepting the Payouts Terms.

One signature, every transfer in a single transaction
POST /api/payroll/run, then /submit with your signed XDR
Testnet: 2 settled runs, 4 recipients paid
Mainnet: invite-only, 0 runs to date
Open Payouts
Step 6

Pull a report

Reporting summarizes what is already recorded - payments by gateway, anchored receipts and payout runs - per network and period, and exports it. It is read-only: it cannot sign or move anything.

GET /api/reporting/summary?network=testnet or mainnet
GET /api/reporting/export for a full export
Also from the CLI: nirium report summary / export
Same numbers as the node row on /analytics
See it on Analytics
Step 7

Watch it in the Agents console

The dashboard and Agents console show real-time status for each node (Settlement, Treasury, Audit Trail, Payroll), pulled live from the agent's own API - not a static mock.

Live status per node
Links to the real evidence behind each claim
Same data as /api/stats
No action required, read-only view
Agents Console

FOR DEVELOPERS

Stellar Code of Conduct

Nirium aligns with the Stellar Code of Conduct: non-custodial by design, and every claim on this site traces to a real tx, CID or GitHub PR you can check yourself at nirium.xyz/verify.

CLI

Install npm install -g nirium-cli for anchor, verify, status and doctor. Anchoring a record is opt-in per call, not automatic.