API v1.0

GUAP Public API

Integrate prediction markets into your app. Enable your users to trade on real-world events with our simple REST API.

REST API
API Key Auth
Rate Limited

Quick Start

1. Get API Key

Contact us to register as a partner and get your API credentials.

Authorization: Bearer gp_live_xxxxxxxxxxxxxxxx

2. Create User

Create or get a user using your own external ID (e.g., phone number).

curl -X POST https://www.guap.gold/api/v1/users \
  -H "Authorization: Bearer gp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"externalId": "255712345678"}'

3. Place Trade

Let your users trade on prediction markets.

curl -X POST https://www.guap.gold/api/v1/trades \
  -H "Authorization: Bearer gp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "255712345678",
    "marketId": "clxyz123",
    "side": "YES",
    "amountTzs": 5000
  }'

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer gp_live_xxxxxxxxxxxxxxxx
FREE
100/min
BASIC
500/min
PRO
2,000/min
ENTERPRISE
10,000/min

API Endpoints

Users

Wallet

Markets

Trading

Positions & Redemption

Fee Structure

5%
Entry Fee
Deducted at trade time
5%
Settlement Fee
Deducted at redemption
~9.75%
Total Per Cycle
All fees go to platform.

Partners keep 100% of their own fees.

Error Codes

400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Server Error

Ready to Integrate?

Register for a partner account to get your API credentials instantly.

Request API Access