Query AceDataCloud Platform Distribution Promotion Information

Return the current account's distribution (affiliate marketing) data — including exclusive distribution links, the number of invited subordinate users, total commissions, withdrawable balance, recent transaction records, etc.

Applicable scenarios:

  • Embed the "Earn Commissions" panel in your own products.
  • Automated invitation scripts, invitation dashboards.
  • Pull details during monthly settlements.

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/.

Interface Overview

Item Content
Method GET
URL https://platform.acedata.cloud/api/v1/distribution/
Authentication ✅ Requires account token

Authentication Instructions (How to Obtain Account Token)

Request Header:

Authorization: Bearer platform-v1-92eb****629c

How to obtain: Log in to the AceDataCloud Platform → Account Token Console → Click the "Create" button. For details, see Manage AceDataCloud Platform Account Tokens.

Request Example

cURL

curl 'https://platform.acedata.cloud/api/v1/distribution/' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/distribution/",
    headers={"authorization": "Bearer platform-v1-92eb****629c"},
    timeout=10,
)
data = resp.json()
print(f"Exclusive promotion link: {data['referral_url']}")
print(f"Number of invited users: {data['referred_users_count']}")
print(f"Total commissions: ¥{data['total_commission']}")
print(f"Withdrawable balance: ¥{data['withdrawable_balance']}")

Node.js

const r = await fetch('https://platform.acedata.cloud/api/v1/distribution/', {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

Response Example (HTTP 200)

{
  "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
  "referral_code": "ABC123XYZ",
  "referral_url": "https://platform.acedata.cloud/?ref=ABC123XYZ",
  "referred_users_count": 87,
  "active_users_count": 31,
  "commission_rate": 0.20,
  "total_commission": 4521.30,
  "withdrawable_balance": 1820.50,
  "pending_balance": 124.30,
  "withdrawn_total": 2576.50,
  "currency": "CNY",
  "recent_orders": [
    {
      "order_id": "fa927d12-...",
      "referred_user_id": "uuser-abc...",
      "amount": 63.2,
      "commission": 12.64,
      "paid_at": "2026-04-25T15:23:00Z"
    }
  ],
  "tier": "Standard",
  "next_tier_at": 10000,
  "all_tiers": [
    { "name": "Standard",   "min_commission": 0,     "commission_rate": 0.20 },
    { "name": "Pro",        "min_commission": 1000,  "commission_rate": 0.25 },
    { "name": "Enterprise", "min_commission": 10000, "commission_rate": 0.30 }
  ]
}

Response Field Description

Field Type Description
user_id UUID Current user ID
referral_code string Exclusive promotion code
referral_url string Complete promotion link (including ?ref= parameter)
referred_users_count integer Total number of users registered through this link
active_users_count integer Number of active users who have made payments
commission_rate number Current commission rate (settled orders are divided at this rate)
total_commission number Total commissions (including withdrawn, withdrawable, and pending)
withdrawable_balance number Current balance available for immediate withdrawal
pending_balance number Pending balance (orders transfer to withdrawable after 3 days)
withdrawn_total number Total amount withdrawn historically
currency string Settlement currency code
recent_orders array Recent orders with distribution relationships (up to 20), including order_id / referred_user_id / amount / commission
tier string Current promotion level
next_tier_at number Cumulative commission required to reach the next level
all_tiers array Definitions of all levels

Error Handling

HTTP Code Meaning
401 not_authenticated Missing account token
403 not_enabled Your account has not enabled the distribution feature (contact customer service to enable)

Practical Tips

  • 3-day settlement lock period: After the invited user pays, the commission first enters pending_balance, and after 3 days without refunds, it transfers to withdrawable_balance.
  • Multi-level distribution: By default, only one level is supported (commissions are earned only when invited users pay). For multi-level distribution, please contact customer service to enable the enterprise version.
  • Withdrawal: Manually initiate withdrawals in the AceDataCloud Platform Distribution Center, supporting Alipay, bank cards, and USDT.
  • Promotional materials: Download posters, banners, and email templates from the Distribution Center.