Skip to main content

API Overview

RP1 provides multiple APIs for interacting with the network.

Endpoints​

Mainnet​

APIEndpoint
RESThttps://api.rp.one
gRPCgrpc.rp.one:9090
RPChttps://rpc.rp.one
WebSocketwss://rpc.rp.one/websocket
EVM RPChttps://evm.rp.one

Testnet​

APIEndpoint
RESThttps://api.testnet.rp.one
gRPCgrpc.testnet.rp.one:9090
RPChttps://rpc.testnet.rp.one
WebSocketwss://rpc.testnet.rp.one/websocket
EVM RPChttps://evm.testnet.rp.one

API Types​

REST API​

Standard HTTP REST endpoints for querying state and submitting transactions.

# Get account balance
curl https://api.rp.one/cosmos/bank/v1beta1/balances/rp1address...

# Get transaction
curl https://api.rp.one/cosmos/tx/v1beta1/txs/TXHASH

gRPC​

High-performance binary protocol for service-to-service communication.

# Using grpcurl
grpcurl -plaintext grpc.rp.one:9090 cosmos.bank.v1beta1.Query/Balance

Tendermint RPC​

Low-level consensus and network queries.

# Get status
curl https://rpc.rp.one/status

# Get block
curl https://rpc.rp.one/block?height=1000

WebSocket​

Real-time event subscriptions.

const ws = new WebSocket('wss://rpc.rp.one/websocket');
ws.send(JSON.stringify({
  jsonrpc: '2.0',
  method: 'subscribe',
  params: ["tm.event='Tx'"],
  id: 1,
}));

Authentication​

Public endpoints require no authentication. Rate limits apply:

EndpointRate Limit
REST100 req/min
gRPC1000 req/min
RPC100 req/min
WebSocket10 connections

For higher limits, run your own node or contact team for API access.

Response Format​

Success Response​

{
  "height": "12345",
  "result": {
    // ... response data
  }
}

Error Response​

{
  "code": 5,
  "message": "account not found",
  "details": []
}

Common Queries​

Account Balance​

GET /cosmos/bank/v1beta1/balances/{address}

Transaction Status​

GET /cosmos/tx/v1beta1/txs/{hash}

Block Info​

GET /cosmos/base/tendermint/v1beta1/blocks/{height}

Module Parameters​

GET /rp1/privacy/v1/params
GET /rp1/lending/v1/params
GET /rp1/oracle/v1/params

Module-Specific APIs​

ModuleBase Path
Privacy/rp1/privacy/v1/
Lending/rp1/lending/v1/
Oracle/rp1/oracle/v1/
UTA/rp1/uta/v1/
InstaWrap/rp1/instawrap/v1/
Fee Burn/rp1/feeburn/v1/

Next Steps​