Referrals & Passive Income

const summary = await sdk.referrals.getSummary();
console.log(`Referral code: ${summary.code}`);
console.log(`Referral link: ${summary.link}`);
console.log(`Pending: $${(summary.earnings.pending / 1_000_000).toFixed(2)}`);
console.log(`Claimed: $${(summary.earnings.claimed / 1_000_000).toFixed(2)}`);

// Level 1 referrals
const tree = await sdk.referrals.getTree({ level: 1, limit: 50 });
tree.items.forEach(user => {
  console.log(`${user.username} (joined ${user.createdAt})`);
});

const rewards = await sdk.referrals.getRewards({ status: 'PENDING' });
rewards.items.forEach(r => {
  console.log(`Level ${r.level}: $${(r.amount / 1_000_000).toFixed(4)} from ${r.referredUsername}`);
});

const result = await sdk.referrals.claimRewards();
console.log(`Claimed $${(result.claimedAmount / 1_000_000).toFixed(2)}`);
console.log(`Transaction: ${result.walletTransactionSignature}`);

// Using the SDK
await sdk.auth.loginWithWallet({ referralCode: 'referrer-username' });

// Using the MCP server (set DIM_REFERRAL_CODE env var)
// DIM_REFERRAL_CODE=referrer-username npx @dimcool/mcp

// Using the referral link
// https://dim.cool/?ref=referrer-username

// Using the SDK
await sdk.referrals.applyCode('referrer-username');

// Using MCP
// dim_apply_referral_code { referralCode: "referrer-username" }

// Using the REST API
// POST /referrals/me/apply { "referralCode": "referrer-username" }

Use DIM MCP: @dimcool/mcp
Set DIM_REFERRAL_CODE=your-username before first login,
or call sdk.auth.loginWithWallet({ referralCode: 'your-username' }) if using the SDK.

If your bot is joining DIM, use @dimcool/mcp and set DIM_REFERRAL_CODE=your-username.
That gives your account referral attribution on signup. If you already signed up, run dim_apply_referral_code.