API Overview

Introduction

The FaaSFi API provides a unified interface to access global prediction market liquidity. Rather than managing three separate integrations (Polymarket, Kalshi, Limitless), developers can interact with a single normalized REST and WebSocket API. The FaaSFi Aggregation Engine handles the complexity of underlying chain interactions, regulatory routing, and order splitting.

Base URL

  • Production: https://api.faas.finance/v1

  • Sandbox: https://sandbox-api.faas.finance/v1

Authentication

FaaSFi uses API Keys for server side authentication. You must include your API Key in the X-API-KEY header of every request.

Example Request:

curl -X GET https://api.faas.finance/v1/markets \
  -H "X-API-KEY: your_api_key_here"

Security Note: Never expose your API Key in client side code (browsers). For frontend applications, please use the FaaSFi.js SDK with wallet signature authentication (SIWE - Sign In With Ethereum).

Rate Limits

To ensure platform stability, the API enforces the following rate limits per IP address:

  • Public Data: 100 requests per second.

  • Private Execution: 50 requests per second.

  • Websockets: 5 active connections per user.

Responses exceeding these limits will receive a 429 Too Many Requests status code.

PreviousLimitless IntegrationNextGet Aggregated Odds

Last updated