​
Overview

Storyprovides RPC APIs for interacting with the blockchain through multiple protocols:

URI over HTTP

RESTful API endpoints for simple requests

JSONRPC over HTTP

Standard JSON-RPC 2.0 over HTTP POST

JSONRPC over WebSocket

Real-time subscriptions and notifications

​
Base URL

https://story-rpc-001.originstake.com

​
Rate Limiting

All API endpoints are rate limited to 15 requests per second per IP address. Exceeding this limit will result in HTTP 429 (Too Many Requests) responses.

To handle rate limits properly:

  • Implement exponential backoff
  • Cache frequently requested data
  • Batch requests when possible
  • Monitor rate limit headers in responses

​
Authentication

No authentication is required for public RPC endpoints. However, we recommend:

  • Using secure connections (HTTPS)
  • Following best practices for key management
  • Implementing request signing for sensitive operations

​
Request Format

curl https://story-rpc-001.originstake.com/block?height=1

​
Response Format

All responses follow standard JSON-RPC 2.0 format:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    // Response data
  },
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Detailed error message"
  }
}

​
Error Codes

CodeDescription
-32700Parse error
-32600Invalid request
-32601Method not found
-32602Invalid params
-32603Internal error

​
Best Practices

​
SDKs & Tools

Story.js

Official JavaScript SDK for Story

Story CLI

Command-line interface for interacting with Story

Need help? Join our Discord for support or check out the GitHub repository for examples.