Developer Documentation

AMUX REST API Reference

Integrate your Discord bot, custom storefront, or automation script directly with the AMUX Store engine using your personal developer API keys.

Generate API Key in DashboardTop Up MX Coins

Base URL & Headers

All headless requests are served over HTTPS with JSON payloads and Bearer token headers:

Base: https://amux.store/api/v1
Auth: Authorization: Bearer <API_KEY>
Format: Content-Type: application/json

Security & Margins

Purchases made with your API key automatically apply your account's Reseller Wholesale Discounts (50-60%) and deduct MX Coins atomically.

💡 Keep your API keys confidential. Revoke them instantly at any time from your Account Dashboard.

Quickstart Code Examples

curl -X POST https://amux.store/api/v1/buy \
  -H "Authorization: Bearer amux_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "cmuzn3y4x0000tgwirbpw0sfi",
    "quantity": 1
  }'

API Endpoints Reference

GET/api/v1/user/balance

Fetches the current user's MX Coins balance, wholesale reseller status, and discount margin.

Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "userId": "usr_99182312",
    "username": "amux_developer",
    "email": "dev@example.com",
    "mxCoins": 4500,
    "resellerStatus": "APPROVED",
    "resellerDiscount": 50
  }
}
GET/api/v1/products

Returns the complete catalog of active products with their live MX Coin pricing, categories, and stock availability.

Sample JSON Response (200 OK)
{
  "success": true,
  "data": {
    "products": [
      {
        "id": "cmuzn3y4x0000tgwirbpw0sfi",
        "name": "Nitro 1 Month Boost Key",
        "slug": "nitro-1-month-boost-key",
        "productType": "CODE",
        "coinPrice": 500,
        "inStock": true,
        "availableStock": 14
      }
    ]
  }
}
POST/api/v1/buy

Purchases the specified product using your MX Coins wallet balance. Digital license keys or download tokens are instantly returned in the payload.

Request Payload (JSON)
{
  "productId": "cmuzn3y4x0000tgwirbpw0sfi",
  "quantity": 1,
  "couponCode": "SUMMER20" // optional
}
Response Payload (200 OK)
{
  "success": true,
  "data": {
    "order": {
      "orderNumber": "AMUX-841920",
      "status": "PAID",
      "totalCoinsPaid": 250, // Reseller 50% applied
      "remainingCoins": 4250,
      "deliveredCodes": [
        "NITRO-ABCD-EFGH-1234"
      ]
    }
  }
}