API Reference

StoryRPC API documentation

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

URI Style

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

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

Best Practices

Performance Optimization

• Cache responses when appropriate
• Use pagination for large result sets
• Subscribe to WebSocket events instead of polling

Error Handling

• Implement proper error handling
• Use exponential backoff for retries
• Monitor response status codes

Security

• Use HTTPS for all requests
• Validate all responses
• Implement request signing when needed

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.