API Reference - IPWorld.io

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "block",
  "params": {
    "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.

​Overview

URI over HTTP

JSONRPC over HTTP

JSONRPC over WebSocket

​Base URL

​Rate Limiting

​Authentication

​Request Format

​Response Format

​Error Codes

​Best Practices

​SDKs & Tools

Story.js

Story CLI

Overview

Base URL

Rate Limiting

Authentication

Request Format

Response Format

Error Codes

Best Practices

SDKs & Tools