Skip to main content

points export - Export Server's Member Points

Command Title​

/points export

Description​

This command allows you to export Discord server's member points data into a CSV file. It's useful for tracking, reporting, leaderboard management, and rewards distribution. You can specify a time period for the points, set a custom date range, limit the number of members in the export, and optionally select a specific wallet type to include.

Usage​

/points export [period] [date_range] [limit] [wallet]

Parameters​

Optional Parameters:​

  • [period]: The time range for the points data.
    • All: Exports the member's current points balance (Default).
    • Today, This Week, This Month, 7-Day, 30-Day: Exports the total points earned within that specific period.
    • Custom: Allows you to define a specific date range using the [date_range] parameter.
  • [date_range]: Sets a custom date range for the export (e.g., 2025-01-01,2025-12-31).
    • Only required if [period] is set to Custom.
  • [limit]: The number of members to include in the export.
    • Default is 0, which exports all members who currently have a points balance greater than 0.
  • [wallet]: Select a specific wallet type to include in the export data.
    • None: Wallet data will not be included (Default).
    • BTC, ETH, SOL: Includes the selected wallet address associated with each member.

Examples​

  • Example 1: Export the current point balance for all members to a CSV file.

    /points export period:All

  • Example 2: Export the top 100 members who earned points in the last 7 days.

    /points export period:7-Day limit:100

  • Example 3: Export all members' points earned within a custom date range, including their associated BTC wallet information.

    /points export period:Custom date_range:2025-07-01,2025-07-31 wallet:BTC

Notes​

  • This feature is restricted to the ULTIMATE subscription tier.
  • The resulting file will be a CSV (Comma Separated Values) file.
  • If period is set to Custom, you must provide a valid start and end date in the date_range parameter (format YYYY-MM-DD).
  • The exported data for non-All periods represents the accumulated points earned during that time, not the current balance.

FAQs​

  • Q: What is the difference between All and other period options?

    A: All exports the member's current point balance. Other periods (e.g., This Month, 7-Day) export the total points the member earned specifically during that time frame.

  • Q: What happens if I set a limit but there aren't that many members with points?

    A: The export will simply include all members who have points, up to the limit you set. It won't create empty entries.

  • Q: Can I export data for a single member?

    A: This command exports server-wide data. To view a single member's points, use the appropriate member-specific command (e.g., /profile).