API Overview

Access Orca’s public REST API for pool data, token information, and protocol analytics.

Orca Public API

The Orca Public API provides programmatic access to Whirlpool data, token information, and protocol analytics on Solana.

Base URL

https://api.orca.so/v2/{chain}

Chain	Base URL
Solana	https://api.orca.so/v2/solana

Authentication

The Orca Public API is open and does not require authentication for read access.

Rate Limits

The API implements rate limiting to ensure fair usage. If you receive a 429 status code, reduce your request frequency.

Response Format

All responses follow a consistent wrapper format with pagination support:

{
  "data": <object or array>,
  "meta": {
    "next": "<cursor or null>",
    "previous": "<cursor or null>"
  }
}

Pagination

Use cursor-based pagination for large result sets:

Parameter	Type	Description
next	string	Cursor for the next page of results
previous	string	Cursor for the previous page of results
size	integer	Number of results per page (default varies by endpoint)

Time Periods

Many endpoints support time-based statistics. Available periods:

Period	Description
5m	5 minutes
15m	15 minutes
30m	30 minutes
1h	1 hour
2h	2 hours
4h	4 hours
8h	8 hours
24h	24 hours
7d	7 days
30d	30 days

Error Responses

Status Code	Description
200	Success
400	Invalid request parameters
404	Resource not found
429	Rate limit exceeded
500	Internal server error

Quick Examples

cURL

# Get all pools on Solana
curl "https://api.orca.so/v2/solana/pools"

# Search for SOL pools
curl "https://api.orca.so/v2/solana/pools/search?q=SOL"

# Get protocol TVL
curl "https://api.orca.so/v2/solana/protocol"

Whirlpools

Query pool data, search pools, and get liquidity information

Protocol

Access TVL, volume, fees, and ORCA token statistics

Tokens

Search and retrieve token metadata and pricing

Schemas

Complete data model reference