Quick Start Guide

Follow this step-by-step workflow to register a new NFT listing on Mintpad using your partner key and display listings in your app.

Integration Workflow

1. Obtain Partner API Key

Request an API key by creating a ticket in our Discord and include it in all headers as x-api-key: your_key_here.

1. Query Whitelisted Collections

Call the /v1/collections endpoint to verify the NFT you want to list is supported.

1. Build Typed Data Signature Structure

Post details to the /v1/listings/typed-data builder endpoint to construct the exact EIP-712 parameters for user signing.

1. Request User Signature

Pass the returned typedData object to the user's Web3 wallet (e.g. MetaMask, Rabby) to prompt an EIP-712 signature.

1. Submit Signed Listing

Submit the signature back along with the maker order parameters via the POST /v1/listings endpoint to activate the listing on the marketplace.

1. Track Referral Earnings

Monitor referred sales and accrued earnings via /v1/referrals/sales and /v1/referrals/summary.

AI-Assisted Development

If you are using AI coding assistants or custom LLM agents to integrate the Mintpad Partner API, you can copy the full Partner API documentation block below. This provides the AI with the complete set of endpoints, schemas, validation rules, and EIP-712 signing code in a single action.