Developers & API
A single HTTP endpoint for placing and tracking orders programmatically.
DEORACLE X exposes a simple JSON API so you can plug your DEORACLE X balance straight into your own storefront, bot, or script — the same convention used by most SMM panel scripts, so existing integrations tend to work with little to no changes. You'll need an account and your personal API key to get started.
Every request is authenticated with a key parameter — your personal API key. Find it on your
API Access page after logging in. Send it as a POST or GET field alongside
action.
Returns every active service, its category, rate per 1000 (in NGN), and quantity limits.
| Field | Description |
|---|---|
| service | Service ID, used when placing an order |
| name / category | Service name and category |
| rate | Price per 1000 units, in NGN |
| min / max | Minimum and maximum order quantity |
| type | Service type |
Debits your wallet balance and submits the order for delivery.
Returns {"order": 12345} on success, or {"error": "..."} — common errors are an
invalid service ID, an invalid link, a quantity outside the service's min/max range, or an insufficient
wallet balance.
Returns the order's charge, start_count, status (e.g. pending,
processing, completed, partial, canceled), and remains.
Returns {"balance": "0.00", "currency": "NGN"}.
Every account has a second, dedicated sandbox key alongside its real API key — find both on your API Access page. Authenticate with the sandbox key instead of the real one to test your integration with zero real side effects: no balance is debited, no order row is created, and no provider is ever contacted, on every action, automatically. There's no flag to remember — just swap the key.
| Action | Sandbox behavior |
|---|---|
| services | Returns the real, live service catalog (read-only either way) |
| add | Validates inputs and returns the same errors a real call would, but returns a fake order ID (90000000–99999999) instead of charging your balance |
| status | Returns a canned, deterministic response for any order ID in the sandbox range |
| balance | Always returns a fixed 1000.00, tagged "sandbox": true |
Because the sandbox key never touches real money or providers regardless of action, it's safe to hardcode into test suites or hand to a teammate who's only building the integration.
Keep your API key secret — anyone with it can spend your wallet balance. If you're a reseller, orders placed through the API are priced using your reseller rates automatically. Running into an issue integrating? Reach us at deoracle@deoracle.com.ng or via our Contact page.