Skip to main content
Are you ready to build against the Faiground protocol? The sections below cover the REST API, official client SDKs, and how to decode on-chain revert selectors.

​
REST API

The Fairground API is built with ConnectRPC: JSON over HTTP.

API Reference

Endpoints, base URLs, protocol shape, and links to interactive Swagger.

​
Client SDKs

Official SDKs wrap the same services with typed clients, examples, and reference docs.

Python SDK

forte_perpetuals_sdk — async and sync clients, data guides, and generated method reference.

TypeScript SDK

TypeScript/JavaScript client docs as the package and reference are published here.

​
On-chain revert reasons

Transactions that interact with Fairground smart contracts can revert with a 4-byte error selector. Check the reference table to find the plain language explanation of the returend hex code.

Error Selector Reference

Decode on-chain revert reasons from their 4-byte hex.