Get API Key

🔑 Step 1: Get an API Key

To interact with PredictBase programmatically, you need an API key. Your API key is wallet-bound and authorizes actions on your behalf.

You can obtain an API key in two ways:

---

Option A: Get an API Key via PredictBase App (Recommended)

1. Visit https://predictbase.app

2. Connect your wallet

3. Navigate to your profile in the top-right corner and click Developer API Key.

4. Generate an API key

⚠️ Your API key is shown only once. Store it securely.

---

Option B: Get an API Key via API Endpoints

This method is useful for automated setups and bots.

1️⃣ Request a nonce

GET /get-nonce?wallet=0xYourWalletAddress

Full URL

https://api.predictbase.app/get-nonce?wallet=0xYourWalletAddress

Response:

{
  "message": "Sign this message to authorize PredictBase API access..."
}

2️⃣ Sign the message with your wallet

After requesting a nonce from the PredictBase API, you must sign the returned message using your wallet. This proves wallet ownership and authorizes API key creation.

Example (using viem):

const signature = await walletClient.signMessage({
  account: "0xYourWalletAddress",
  message, // message returned from /get-nonce
});

The resulting signature is then sent to the create-api-key endpoint.

3️⃣ Create the API key

POST /create-api-key

Full URL

https://api.predictbase.app/create-api-key

Body:

{
  "wallet": "0xYourWalletAddress",
  "signature": "0xSignedMessage",
  "message": "Signed message containing nonce"
}

Response:

{
  "apiKey": "YOUR_API_KEY"
}

Use this API key in all requests via the x-api-key header.