Referral Tracking

Mintpad automatically tracks referred sales on-chain using transaction indexing.

Attribution Priority (V1)

When an NFT purchase is processed on-chain, Mintpad credits the referral reward to a partner using the following strict priority order:

1. Listing Partner (Primary): If the listing was created through a partner API key (partnerId is set on the listing in our database), that partner always receives 100% of the referral fee.
2. Buyer Partner (Fallback): If the listing has no associated partner (e.g., it was created directly on the Mintpad website), the indexer checks if the buyer generated their buy transaction calldata through a partner API key within the last hour (tracked via the buy attempts cache). If so, that partner receives the referral fee.

1. Retrieve Referral Sales Ledger

Retrieve all credited sales referred by your partner account.

Request

GET /v1/referrals/sales

Headers:

• x-api-key: mp_part_yourkey

Response

{
  "sales": [
    {
      "txHash": "0xsaletxhash...",
      "collectionAddress": "0x29efca787c5337614c8f2709da0105de6b30a393",
      "tokenId": "123",
      "volumeWei": "100000000000000000000",
      "partnerShareWei": "500000000000000000",
      "status": "pending",
      "createdAt": "2026-06-18T13:00:00.000Z",
      "payoutId": null
    }
  ],
  "nextCursor": null
}

2. Retrieve Earnings Summary

Get your aggregated referral earnings status.

Request

GET /v1/referrals/summary

Headers:

• x-api-key: mp_part_yourkey

Response

{
  "totalEarnedWei": "500000000000000000",
  "totalPaidWei": "0",
  "pendingPayoutWei": "500000000000000000"
}