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.
