Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.predictamarkets.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Predicta Markets API gives you programmatic access to markets, trading, account data, and the referral system. It is a REST API that accepts JSON request bodies and returns JSON responses.
API access is not open by default. To request credentials, email api-support@predictamarkets.com.

​
Base URL

https://api.predictamarkets.com

​
Authentication

All authenticated endpoints require an API key passed in the X-Api-Key request header. 
X-Api-Key: your-api-key-here

curl https://api.predictamarkets.com/v1/markets \
  -H "X-Api-Key: your-api-key-here"

​
Creating an API key

You can generate your own API key directly from your account — no need to contact support.
1

Open your Profile

Log in to predictamarkets.com and click your avatar in the top-right corner, then select Profile.
2

Go to API Keys

Scroll to the API Keys section on your Profile page.
3

Create a new key

Click Create API Key, give it a name (e.g. my-integration), and optionally set an expiry date. Click Create.
4

Copy the key immediately

Your key is shown only once. Copy it now and store it somewhere safe — you cannot retrieve it again. If you lose it, rotate the key to get a new one.
API keys grant full access to your account. Never share a key or commit it to source control. If a key is compromised, rotate or revoke it immediately from your Profile.

​
Managing keys

From the API Keys section of your Profile you can:
ActionWhen to use
RotateReplace a key with a new one while keeping the same name and settings — use this if you suspect a key has been leaked
RevokePermanently delete a key — any integrations using it will stop working immediately

​
Errors

All errors follow a consistent shape: 
{ "detail": "Human-readable error message" }
StatusMeaning
400Bad request — check your parameters
401Missing or invalid API key
403Authenticated but not authorised for this resource
404Resource not found
422Validation error — check the response body for field details
500Server error

​
Pagination

List endpoints accept skip and limit query parameters:
ParameterDefault
skip0
limit10

​
Support

For API access requests or integration help: api-support@predictamarkets.com