Introduction

MoneroSMS lets anyone top-up SMS credits with Monero and send texts worldwide—no bank, no card, no personal data. It’s the easiest bridge between the orange coin and real-world messaging: buy credits in seconds, paste an API key, and start delivering OTPs, alerts, or marketing blasts straight from your app.

Getting Started

1. Credit Fundamentals

Item Detail
Currency XMR only; credits priced in real-time using CoinGecko XMR-USD
Billing unit 1 credit → 1 SMS segment (160 GSM / 70 Unicode)
Minimum purchase 0.01 XMR (≈ 50 credits at press time)
Expiry Never—credits stay on your account until used

2. Using MoneroSMS

  1. Create an account (email optional) → dashboard shows a unique sub-address.
  2. Send XMR to that address; confirmations appear after 1 block.
  3. Credits instantly populate; copy your API key.
  4. POST to /v1/send with to, message, and api_key.
  5. Track delivery status in real time on the dashboard or via webhook callbacks.

3. Coverage & Throughput

Region Cost / credit Delivery time (avg) Notes
North America 1 credit <4 s Long-code routes
EU 27 1 credit <5 s GDPR-compliant providers
LATAM 1.2 credits 6–8 s Automatic Unicode handling
Asia-Pacific 1.4 credits 5–10 s Direct operator connections
Africa 1.6 credits 8–12 s Lower-priority routes

Burst cap: 20 SMS/s per account by default—free upgrade on request.

4. Pricing & Fees

Action Fee
Credit purchase Spot XMR rate × credits; 0 % surcharge
SMS send Deducts credits per message segment
Inbound SMS (beta) Free during pilot
Refund 0 %—unused credits convertible back to XMR at current rate

5. API Essentials

  • Endpoint POST /v1/send
    • to (E.164), message, api_key
  • Webhook POST /v1/status
    • HMAC-SHA256 signed with your personal secret
  • Libraries – official Python, Node, Go SDKs (pip/npm/go get: monerosms-sdk)

Full docs: https://docs.monerisms.com

6. Security

  • Payments settle directly on-chain; no custodial hold.
  • Dashboard and API served over TLS 1.3; Tor onion mirror available.
  • Phone numbers encrypted at rest (AES-GCM).
  • Two-factor login (Monero signature + TOTP) optional.

7. Reliability & SLA

99.8 % monthly uptime backed by redundant upstream carriers and automatic failover.
Realtime status page: https://status.monerisms.com

8. Integrations

  • WordPress/WooCommerce – plugin sends order updates by SMS.
  • Grafana & Prometheus – alertmanager webhook template included.
  • Nextcloud – SMS login flow via OAuth app.
  • Zapier – “Send MoneroSMS message” action (beta).

9. Troubleshooting Quick Chart

Issue Likely cause Fix
“Insufficient credits” Pending XMR confirmation Wait one block or bump fee
HTTP 401 Wrong API key Regenerate key in dashboard
Delayed delivery >30 s Destination carrier queue Retry or open ticket with message ID
Webhook signature mismatch Using old secret Update header or rotate secret

11. Bottom Line

MoneroSMS converts XMR into instantly usable SMS connectivity with zero KYC, industry-standard delivery, and straightforward pricing. Whether you’re sending 2FA codes to a dozen users or marketing to ten thousand, you stay private, your recipients stay reachable, and no bank ever gets involved.

Community & Resources