API Reference
Endpoints & Rate Limits
Testnet 122606
Section
API Reference
Documentation category
Type
Guide
Technical reference
Summary
Base RPC URL, required headers, rate limit tiers, and CORS policy.
Article Content

Base URL

All API requests target a single base URL:

https://testnet.swssrpc.swss.io

During development you may also use the testnet endpoint directly from the DevHub portal's built-in RPC Tester.

Request Headers

Header Required Description
Content-Type Yes Must be application/json
X-SWSS-API-Key Recommended Your developer API key

Requests without X-SWSS-API-Key are subject to stricter rate limits and may be restricted during high traffic periods.

Rate Limits

Tier Limit
Unauthenticated 20 requests / minute
Authenticated (API key) 300 requests / minute
Burst Up to 3× for 10 seconds

Rate limit headers are included in every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 297
X-RateLimit-Reset: 1700000060

When the limit is exceeded, the endpoint returns HTTP 429 Too Many Requests.

CORS

The RPC endpoint allows cross-origin requests from any origin for authenticated clients. Unauthenticated browser requests may be rejected depending on traffic conditions.

For production applications, make RPC calls from a server-side proxy rather than directly from the browser — this also prevents exposing your API key in client-side code.

TLS

All connections must use HTTPS (TLS 1.2+). Plain HTTP requests are rejected.