Rivier Documentation

Full-stack APIs for agentic commerce — payments, wallets, identity, settlement, and AI across 15 chains.

15 Chains5 ProtocolsRIVR SettlementCanton/CBDCAgent IdentityNon-Custodial MPC

Quick Start

1. Create an account at app.rivier.ai

2. Create an API key at platform.rivier.ai/keys

3. Make your first request:

curl https://api.rivier.ai/developer/commerce/token/info \
  -H "Authorization: Bearer rv_your_key"

Authentication

Authenticate via API key, JWT, or session cookie:

Rivier Token (RIVR)

Programmable settlement unit. 1 RIVR = $1.00 USD, reserve-backed, minted on Tenzro multi-VM (EVM + SVM + DAML).

GET/developer/commerce/token/info
Token details, supply, reserves
POST/developer/commerce/token/mint
Request RIVR minting (institutional)
POST/developer/commerce/token/redeem
Redeem RIVR to USDC/USDT

Payments

5 protocols with auto-routing. Micropayments under $0.10 batched for 97.9% gas reduction.

POST/developer/commerce/pay
Initiate payment (auto-routes protocol)
POST/developer/commerce/pay/quote
Payment quote (fees, route, ETA)
POST/developer/commerce/pay/batch
Batch micropayments
POST/transaction/intent
Create transaction intent
POST/transaction/simulate
Simulate transaction
curl -X POST https://api.rivier.ai/developer/commerce/pay \
  -H "Authorization: Bearer rv_key" \
  -H "Content-Type: application/json" \
  -d '{"to":"did:tenzro:machine:abc","amount":"10.00","asset":"RIVR"}'

Wallets

Non-custodial threshold wallets auto-provisioned across 15 chains.

Chains: Tenzro, Base, Ethereum, Polygon, Optimism, Arbitrum, Tempo, Avalanche, BNB, Solana, Canton, Tron, Aptos, Sui, Polkadot

GET/wallet
List wallets
GET/wallet/:id/balance
Token balances
GET/wallet/:id/nfts
NFT holdings
GET/portfolio
Unified cross-chain portfolio
POST/wallet/profiles
Create profile + provision chains

Identity

3-tier: Rivier UUID → Tenzro DID → Canton Party.

POST/identity/guardian
Create guardian identity (KYC required)
POST/identity/agent
Create agent under guardian
GET/identity/resolve/:did
Resolve DID to record

Agents

Deploy AI agents with wallets, skills, policies. Agent wallets capped at 100 RIVR ($100).

POST/agent
Create agent with persona and skills
GET/skills/catalogue
Browse 25+ built-in skills
POST/agents/library/subscribe
Subscribe to pre-designed agent

Policy Engine

Every transaction evaluated before execution. Spending limits, chain controls, delegation scopes.

POST/policy
Create policy bundle
POST/policy/evaluate
Evaluate transaction against policies
POST/delegation
Create delegation to agent

Bridge

Cross-chain via LayerZero V2, deBridge DLN, Chainlink CCIP. Swaps via 1inch Fusion+ and Jupiter Ultra. Fiat via Bridge.xyz.

POST/bridge/quote
Bridge quote
POST/bridge/execute
Execute bridge
POST/bridge/onramp
Fiat on-ramp
POST/bridge/offramp
Fiat off-ramp

Intelligence

Market data, signals, semantic search, AI analyst APIs, MCP server.

GET/intelligence/markets
Market data (public)
POST/intelligence/search
Semantic search
POST/intelligence/analyst/market
AI market analysis
POST/mcp
MCP server (HTTP)

Curator AI

AI financial advisor with agent injection. Pass agent_id to inject agent persona.

POST/curator/chat
Chat (supports agent_id)
POST/curator/execute
Execute proposed action

Settlement

Canton CIP-0056 atomic settlement. DVP for multi-asset trades. CBDC-compatible.

POST/developer/commerce/settle
Atomic settlement
POST/developer/commerce/settle/dvp
Delivery-vs-payment

Events

SSE streaming, webhooks, chain event indexing across 15 chains.

GET/events/stream
SSE real-time stream
POST/developer/webhooks
Create webhook

Events: transaction.*, wallet.*, agent.*, bridge.*, receipt.*

API Keys

Create at platform.rivier.ai/keys. Prefix: rv_

POST/developer/keys
Create key
GET/developer/keys
List keys

Webhooks

HMAC-SHA256 signed. Secret prefix: whsec_

POST/developer/webhooks
Create webhook
GET/developer/webhooks/events
Event types

Scopes

Rate Limits

Errors

{"error":"validation_error","message":"Amount exceeds $100 cap"}

© 2026 Rivier