> ## Documentation Index
> Fetch the complete documentation index at: https://gateway.wasmou.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Wasmou API documentation

> Everything you need to sell Wasmou products from your own shop, bot or reseller panel.

Welcome to the **Wasmou API**, your complete solution for digital services in Algeria. One API key gives your software the same power as the Wasmou app: browse the catalog, buy with your wallet, receive codes, and top up games.

> [card] [Quickstart](https://gateway.wasmou.net/quickstart.md)
>
> Your first purchase in five minutes.

> [card] [Authentication](https://gateway.wasmou.net/authentication.md)
>
> API key, IP allow-list and rotation.

> [card] [Catalog](https://gateway.wasmou.net/services/catalog.md)
>
> All products, prices, delivery mode and stock in one call.

> [card] [Errors](https://gateway.wasmou.net/errors.md)
>
> Status codes, messages and how to recover.

## Base URL

```
https://api.wasmou.net/api
```

> [!NOTE]
>
> Every endpoint in this documentation is relative to `/api`. The host used to be `gateway.wasmou.net`; **only the host changed**. Paths, request bodies and responses are the same, so migrating an existing integration means replacing the hostname.

## Currency

All prices and balances are in **DZD** (Algerian dinar).

## Available services

| Service | What it does | Guide |
| - | - | - |
| **Account** | Profile, balance and available balance. | [Account & balance](https://gateway.wasmou.net/services/account.md) |
| **Catalog** | The full product list with your prices and stock. | [Catalog](https://gateway.wasmou.net/services/catalog.md) |
| **Products** | Licence keys, subscriptions and gift cards: browse, buy, retrieve codes. | [Products](https://gateway.wasmou.net/services/products.md) |
| **Orders** | One history across every service. | [Orders](https://gateway.wasmou.net/services/orders.md) |
| **Stock** | Units reserved for your account. | [Stock](https://gateway.wasmou.net/services/stock.md) |
| **Flexy** | Mobile credit, offers and bills for Mobilis, Ooredoo and Djezzy, plus international credit. Bulk volumes supported. | [Flexy](https://gateway.wasmou.net/services/flexy.md) |
| **Game top-ups & Telegram** | Free Fire, PUBG Mobile, Mobile Legends, Genshin, Telegram Premium and Stars, by player ID. | [Top-ups](https://gateway.wasmou.net/services/topups.md) |

## Authentication

All requests need your API key in a header:

```
X-Api-Key: your_api_key_here
```

## Response format

```json Success theme={"dark"}
{
  "status": "success",
  "message": "Operation completed successfully",
  "data": { }
}
```

```json Error theme={"dark"}
{
  "status": "error",
  "message": "Error description",
  "data": null
}
```

## Rate limiting

**60 requests per minute** per API key. Beyond that the API answers `429 Too Many Requests`. See [Errors](https://gateway.wasmou.net/errors.md#handling-rate-limits) for a back-off strategy.

## Quick start

1. Get your API key from the [Wasmou dashboard](https://myapp.wasmou.net/app/api-access).
2. Check your balance: `GET /api/account`.
3. Browse the [catalog](https://gateway.wasmou.net/services/catalog.md) and place orders.
4. Track every order with the IDs the API returns.

```mermaid theme={"dark"}
sequenceDiagram
  participant You
  participant API as Wasmou API
  You->>API: GET /catalog
  API-->>You: products, prices, delivery mode, stock
  You->>API: POST /products/purchase/{variantId}
  API-->>You: order_ids
  You->>API: POST /products/orders/retrieve
  API-->>You: status + code (key)
```

## Useful links

* [Dashboard](https://myapp.wasmou.net/app) · [API access](https://myapp.wasmou.net/app/api-access) · [Add funds](https://myapp.wasmou.net/deposit)
* [Support on Telegram](https://t.me/wasmou_app)
* [Changelog](https://gateway.wasmou.net/changelog.md)

*Documentation version 2.0 · October 2026*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.