Block Height
--
Loading...
Total Transactions
--
 
Accounts
--
 
Peers / Consensus
--
 
Create API Key
Generate a new sandbox key
Request Funds
Get test RMZ from faucet
Try an Endpoint
Interactive API explorer
Quickstart Guide
End-to-end in 5 minutes
Recent Activity
Your sandbox interactions
Transaction submitted 0xa3f8...c41d
2 minutes ago
Faucet funded RMZ1qx7k...m9p2 with 10 RMZ
18 minutes ago
API key sk_sand_...7f2a created
1 hour ago
Transaction confirmed 0x91b2...e8f0 in block #184,288
1 hour ago
Getting Started
Complete the onboarding flow
2/5

Create an API Key

Generate your sandbox API credentials

Fund a Test Wallet

Request test RMZ from the faucet

3

Fetch Account Nonce

Get the next nonce for transaction signing

GET /api/v1/accounts/{address}/next_nonce
4

Submit a Transaction

Sign and submit your first transfer

POST /api/v1/transactions
5

Confirm on Explorer

Verify your transaction was processed

GET /api/v1/transactions/{hash}
quickstart.sh
sandbox
1# 1. Check sandbox health
2curl -s "$BASE/api/v1/health" | jq
3
4# 2. Fetch next nonce for your wallet
5curl -s "$BASE/api/v1/accounts/RMZ1.../next_nonce" | jq
6
7# 3. Submit a signed transaction
8curl -s -X POST "$BASE/api/v1/transactions" \
9 -H 'Content-Type: application/json' \
10 -H 'X-API-Key: sk_sand_...' \
11 -d @signed_tx.json
12
13# 4. Confirm transaction
14curl -s "$BASE/api/v1/transactions/{tx_hash}" | jq
2 active keys · 3 remaining
Name Key Prefix Tier Created Last Used Status
Development sk_sand_...7f2a Standard 2026-02-19 2 min ago Active
CI/CD Pipeline sk_sand_...b4e1 Standard 2026-02-18 3 hrs ago Active
Usage Example
curl -H "X-API-Key: sk_sand_YOUR_KEY" https://api.rmoz.sa/api/v1/transactions
Health & Stats
GET /api/v1/health Health check
GET /api/v1/stats Network stats
GET /api/v1/metrics Node metrics
Blocks
GET /api/v1/blocks List blocks
GET /api/v1/blocks/{id} Get block by ID
Transactions
POST /api/v1/transactions Submit transaction
POST /api/v1/transactions/batch Batch submit
GET /api/v1/transactions List transactions
GET /api/v1/transactions/{hash} Get by hash
Accounts
GET /api/v1/accounts List accounts
GET /api/v1/accounts/{address} Get account
GET /api/v1/accounts/{address}/next_nonce Next nonce
GET /api/v1/accounts/{address}/transactions Account txs
GET /api/v1/accounts/{address}/assets Account assets
Assets
GET /api/v1/assets List assets
POST /api/v1/assets Create asset
GET /api/v1/assets/{id} Get asset
Autonomous Programs
GET /api/v1/ap/contracts List contracts
GET /api/v1/ap/contracts/{address} Get contract
GET /api/v1/ap/contracts/{address}/state Contract state
GET /api/v1/ap/executions/{tx_hash} Execution result
GET
Response
Ready
1// Click "Send" to make a live request to api.rmoz.sa

Request Test RMZ

Enter your RMZ1... wallet address to receive sandbox tokens. Amounts are in micro-RMZ (1 RMZ = 1,000,000 micro-RMZ).

100 RMZ
Per key / day
500 RMZ
Per address / day
50 RMZ
Per IP / hour
Recent Faucet Transactions
Your funding history
Address Amount TX Hash Status Time
RMZ1qx7k...m9p2 10 RMZ 0xa3f8...c41d Confirmed 18 min ago
RMZ1qx7k...m9p2 50 RMZ 0x91b2...e8f0 Confirmed 2 hrs ago

Quickstart Guide

Get from zero to your first transaction in 5 minutes. Covers key generation, faucet funding, and tx submission.

Read guide →

API Reference

Complete OpenAPI specification for all /api/v1/* endpoints with request/response schemas.

openapi_enterprise_v1.yaml →

Wallet Integration

Signing payload format, nonce management, Ed25519 key handling, and transaction fields reference.

WALLET_INTEGRATION_GUIDE.md →

Endpoint Catalog

Full list of sandbox-exposed endpoints with exposure policies and access tiers.

09_ENDPOINTS.md →

Units & Decimals

On-chain integer amounts, micro-RMZ conversion (10^-6), and ISO20022 currency display rules.

RMZ_UNITS_AND_DECIMALS.md →

SDK Libraries

Client libraries for Python, JavaScript, Go, Java, and .NET. Auto-generated from the OpenAPI spec.

sdk/ →
1

Get Your API Key

Create an API key from the API Keys page. You'll need this for write operations.

# Your key will look like:
X-API-Key: sk_sand_a1b2c3d4e5f6...
2

Generate a Wallet

Create an Ed25519 keypair. The public key derives an RMZ1... address.

# Using OpenSSL
openssl genpkey -algorithm Ed25519 -out key.pem
openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | xxd -p
3

Fund via Faucet

Request test RMZ from the Faucet page or via API.

curl -X POST "$BASE/faucet/fund" \
-H 'X-API-Key: sk_sand_...' \
-d '{"address":"RMZ1...","amount":10000000}'
4

Fetch Nonce & Submit Transaction

Get the next nonce, sign the payload with Ed25519, and submit.

# Get nonce
curl -s "$BASE/api/v1/accounts/RMZ1.../next_nonce"
# Sign fields: from, to, amount, fee, nonce, timestamp,
# data, public_key, privacy, type, expires_at, version
# Submit signed tx
curl -X POST "$BASE/api/v1/transactions" \
-H 'Content-Type: application/json' \
-H 'X-API-Key: sk_sand_...' \
-d @signed_tx.json
5

Confirm Transaction

Verify your transaction was processed and appears in the explorer.

curl -s "$BASE/api/v1/transactions/{tx_hash}" | jq
# Check in explorer: https://testnet.rmoz.sa/tx/{tx_hash}
Transaction Signing Reference

The canonical signing payload includes these fields in order:

from to amount fee nonce timestamp data public_key privacy type expires_at version

All amounts are integers (micro-RMZ). Never include metadata fields like status, added_at, or block_round.

Admin Access

Changes to user status take effect immediately. Suspended users lose API access.

24
Total Users
19
Active
2
Suspended
3
Pending
47
Total Keys
User Status Tier Keys API Calls (24h) Registered Actions
AD
Active Admin 3 12,481 2026-01-10
AP
Active Partner 5 8,392 2026-01-15
OH
Active Standard 2 1,847 2026-02-19
SK
Active Standard 1 956 2026-02-17
TB
Suspended Standard 0 0 2026-02-18
ND
Pending Standard 0 0 2026-02-20
KF
Pending Partner 0 0 2026-02-20

Platform Configuration

Changes are applied to all users immediately. Use caution with rate limit and faucet adjustments.

Gateway & Rate Limits
Live
Per API key
Per API key
Unauthenticated
For POST endpoints
Faucet Controls
Active
Max funding
Max funding
Abuse control
micro-RMZ (read-only)
Feature Toggles

Public Registration

Allow new developers to sign up without invitation.

Faucet Service

Enable the test token faucet for all users.

Write Endpoints (POST)

Allow transaction submission via gateway.

Batch Transactions

Enable /api/v1/transactions/batch endpoint.

Restricted Endpoints

Expose /metrics, /mempool, /peers to partner tier.

Maintenance Mode

Block all API access and show maintenance page.

Network & Operations
client RMOZ_NODE_MODE
enabled RMOZ_CLIENT_RELAY_ONLY
Sunday 02:00 UTC Automated
2026-02-16 02:00 UTC
Route Exposure Policy
Which /api/v1/* routes are publicly accessible through the gateway
Route Pattern Method Access Auth Required Rate Tier
/api/v1/health GET Public No IP limit
/api/v1/blocks/** GET Public No IP limit
/api/v1/transactions POST Keyed Yes (X-API-Key) Key tier
/api/v1/transactions/** GET Public No IP limit
/api/v1/accounts/** GET Public No IP limit
/api/v1/assets POST Keyed Yes (X-API-Key) Key tier
/api/v1/metrics GET Restricted Partner + Allowlist Partner only
/api/v1/mempool GET Restricted Partner + Allowlist Partner only
/api/v1/peers GET Restricted Partner + Allowlist Partner only
/api/status GET Blocked Ops only N/A
/health GET Blocked Ops only N/A
2026-02-20 00:09 User newdev@example.com registered and OTP verified system
2026-02-19 23:41 User bot@spam-domain.xyz suspended — abuse detected admin@rmoz.sa
2026-02-19 22:15 API key sk_sand_...b4e1 created for dev@atlas-pay.io dev@atlas-pay.io
2026-02-19 21:30 Gateway rate limit updated: Standard tier 500 → 1,000 req/min admin@rmoz.sa
2026-02-19 20:47 Faucet funded RMZ1qx7k...m9p2 with 10 RMZ via key sk_sand_...7f2a omar@findev.co
2026-02-19 20:44 User omar@findev.co logged in (OTP verified) system
2026-02-19 18:20 User sarah@blockchain-labs.kr approved and activated admin@rmoz.sa
2026-02-19 16:00 API key sk_sand_...9c3f auto-revoked (inactive 30 days) system
2026-02-19 14:12 Faucet per-IP limit changed: 30 → 50 RMZ/hr admin@rmoz.sa
2026-02-16 02:00 Scheduled weekly sandbox reset executed — chain state cleared system (cron)
2026-02-15 23:58 5 failed login attempts from IP 203.0.113.42 — IP blocked 15 min system
2026-02-15 11:30 User dev@atlas-pay.io upgraded to Partner tier admin@rmoz.sa