Skip to main content
InsightArena
HomeMarketsEventsLeaderboardDocs
Profile
HomeMarketsEventsLeaderboardDocs
Profile
Developer API

InsightArena API Documentation

Integrate markets, leaderboards, and events into your own apps. This page covers base URLs, authentication, endpoints, and common examples.

Base URL

All requests are served over HTTPS. Use the base URL below for all REST endpoints.

https://api.insightarena.com/v1

Authentication

Authenticate by connecting a wallet, signing a challenge, and exchanging that signature for a short-lived bearer token.

  1. Request a challenge string for your address.
  2. Sign the challenge with your wallet provider.
  3. Exchange the signature for a JWT access token.
  4. Send the token on subsequent requests via Authorization.
Authorization: Bearer <token>

Key Endpoints

Common endpoints are grouped below. Response bodies are JSON unless otherwise noted.

Events

  • GET /events
  • GET /events/:id
  • GET /events/:id/markets

Markets

  • GET /markets
  • GET /markets/:id
  • POST /markets/:id/orders

Leaderboard

  • GET /leaderboard
  • GET /leaderboard/:address
  • GET /leaderboard/stats

Wallet

  • POST /auth/challenge
  • POST /auth/verify
  • GET /me

Example Requests

Fetch upcoming events and place an order. Replace identifiers with real values from your environment.

# List events
curl -s https://api.insightarena.com/v1/events | jq

# Create an order (authenticated)
curl -s https://api.insightarena.com/v1/markets/123/orders \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"side":"YES","amount":"25"}'

Rate Limits & Errors

Clients are rate-limited per IP and per token. When you exceed a limit, you will receive an HTTP 429.

CodeMeaningTypical Fix
401Missing/invalid tokenRe-authenticate
403Insufficient permissionsVerify account/roles
429Rate limitedBackoff + retry
500Server errorRetry later

InsightArena

The premier decentralized prediction market built on Stellar, offering provably fair gaming and competitive leaderboards.

PLATFORM

  • Markets
  • Leaderboard
  • Events
  • Dashboard
  • Profile

RESOURCES

  • Documentation
  • API Docs
  • Smart Contracts
  • GitHub
  • FAQ

COMPANY

  • About Us
  • Contact Support
  • Privacy Policy
  • Terms of Service

COMMUNITY

  • Telegram
  • Twitter
  • Discord
  • Contact Support
  • Terms of Service
  • Privacy Policy

© 2026 InsightArena. All rights reserved. Built on Stellar.