Project API

Our API is intentionally simple. It lets you fetch your project's registered wallets, or check whether a specific wallet or Discord user has registered.

ℹ️ Note: The API is available for premium (upgraded) projects only. Your API Key is on your project dashboard under Tools > API, where you can also regenerate it. Treat the key like a password — anyone who has it can read your entry list.

Wallet List

GET https://www.premint.xyz/pmt/v1/<api_key>/

This returns a list of all the wallets that have registered for your PREMINT list, wrapped in a data object:

{"data": [{"wallet": "0x...", "create_time": "..."}, ...]}

Once you have finalized your raffle, each entry also includes winner and waitlist booleans. Before finalization, those fields are not included.

Responses are cached for up to 10 minutes, so recent registrations can take a few minutes to appear.

Query Parameters

Name Default Description

entry_status

all

Name	Default	Description
entry_status	all	Limit the responses to entries with the status `winner` or `waitlist`. By default, it will return `all` entries. Note: winner / waitlist will only return results after you have finalized your raffle.
include_details	off	Include additional details along with the wallet address: `twitter_username`, `twitter_id`, `twitter_followers_count`, `twitter_account_created`, `discord_username`, `discord_id`, `wallet_balance_at_registration`, `holdings_wallet`, `verified_tokens`, `collab`, and `custom_field`. Enable it by passing `include_details=true`; omit the parameter entirely to leave it off.

Limit the responses to entries with the status winner or waitlist.

By default, it will return all entries. Note: winner / waitlist will only return results after you have finalized your raffle.

include_details off Include additional details along with the wallet address: twitter_username, twitter_id, twitter_followers_count, twitter_account_created, discord_username, discord_id, wallet_balance_at_registration, holdings_wallet, verified_tokens, collab, and custom_field. Enable it by passing include_details=true; omit the parameter entirely to leave it off.

Disqualified entries are never included in API responses.

Check a single wallet or Discord user

You can also check whether one specific user has registered:

GET https://www.premint.xyz/pmt/v1/<api_key>/wallet/<wallet_address>

GET https://www.premint.xyz/pmt/v1/<api_key>/discord/<discord_id>

Both return registered (true/false), your project_name and project_url, and — if the user is registered — their wallet_address and discord_id, plus winner and waitlist once your raffle is finalized. The wallet lookup is case-insensitive, and the Discord lookup expects the numeric Discord user ID (snowflake).

Creators have used the API to build custom integrations like auto-assigning Discord roles to registrants or gating a section of their website to registered users.