SwiPredict

SwiPredict API

Tap into the ultra-high engagement of the swipe for your own personal, professional, and enterprise needs. Whether you're looking to set up a friendly prediction tourney for the big game, or seeking a rapid-fire, modern-day take on the focus group—SwiPredict's API options are a great bet.

API Access Coming Soon

We're building a powerful API to give developers programmatic access to prediction data. Be the first to know when it launches.

Overview

The SwiPredict API will provide RESTful endpoints to access prediction questions, user statistics, leaderboards, and real-time resolution data. Build custom dashboards, integrate predictions into your apps, or create entirely new experiences.

Example Request Preview
const response = await fetch('https://api.swipredict.ai/v1/predictions', { headers: { 'Authorization': `Bearer ${API_KEY}` } }); const predictions = await response.json(); // Returns array of active prediction questions

Planned Endpoints

RESTful endpoints for accessing prediction data:

Predictions
GET /v1/predictions List active predictions
GET /v1/predictions/{id} Get prediction details
GET /v1/predictions/trending Hot predictions by volume
GET /v1/predictions/resolved Recently resolved questions
POST /v1/predictions/custom Create custom prediction
Categories
GET /v1/categories List all categories
GET /v1/categories/{slug}/predictions Predictions by category
Swipes & Engagement
POST /v1/swipes Log a swipe prediction
GET /v1/swipes/stats Aggregate swipe analytics
GET /v1/predictions/{id}/consensus Crowd consensus breakdown
Users & Leaderboards
GET /v1/users/me Current user profile
GET /v1/users/me/stats Your prediction stats
GET /v1/users/me/history Your swipe history
GET /v1/leaderboard Global top predictors
GET /v1/leaderboard/weekly Weekly leaderboard
GET /v1/leaderboard/category/{slug} Category-specific rankings
Tournaments
GET /v1/tourneys List active tournaments
GET /v1/tourneys/{id} Tournament details
POST /v1/tourneys Create private tournament
POST /v1/tourneys/{id}/join Join a tournament
GET /v1/tourneys/{id}/leaderboard Tournament standings
Webhooks
POST /v1/webhooks Register webhook endpoint
DELETE /v1/webhooks/{id} Remove webhook

Gem Tiers

Gems are SwiPredict's premium currency, separate from SwiPoints (SP). Your gem balance determines your Gem Tier — a progression system reflecting your engagement and collecting activity.

Gem Tier Progression 7 Tiers
// Tier Min Gems Description Quartz 0 Raw and uncut — every collector starts here Citrine 50 A warm glow of growing wealth Amethyst 200 Royal purple — your vault deepens Sapphire 500 Cool brilliance of a seasoned trader Emerald 1,000 Deep green fortune — The Keep knows you Ruby 2,500 Fire-forged wealth and influence SwiPrism 5,000 Prismatic legend — light bends around you

How to earn gems: Daily check-ins, challenges, and special events in The Keep.

Gems vs SP: SwiPoints are earned by making predictions and being correct. Gems are earned through engagement activities. Both have their own tier system — Crystal Ball (SP) and Gem Tiers (gems).

SwiPrism: The ultimate gem tier at 5,000+ gems. Unlocks prismatic visual effects across your profile and leaderboard presence.

Back to MassPredict