Перейти к основному содержанию
API даёт те же цифры, что и вкладка «Рефералы» в кабинете. Нужна авторизация (cookie, bearer или x-api-key).

Эндпойнты

МетодПутьВозвращает
GET/referrals/statsdirect, total, by_level[], earned_micro
GET/referrals/tree?depth=2&limit=50Вложенное дерево, постранично
GET/referrals/earnings?limit=100Ledger с kind = 'referral_reward'
GET/ledger?limit=100Полный FLOW-ledger пользователя

SDK

const stats = await af.referrals.stats();
console.log(`${stats.direct} прямых, всего ${stats.total}`);

const earnings = await af.referrals.earnings({ limit: 50 });
const totalEarned = earnings.items.reduce((s, e) => s + Number(e.amount), 0);

const ledger = await af.ledger.list({ limit: 100 });

Пагинация

tree и earnings — cursor-based. Передавай next_cursor из предыдущего ответа.

Вебхуки

Подпишись на payment.received чтобы получать referral.reward события — см. Webhooks.