Skip to content
Aleatoric Data

Quickstart

1. Create an Account

Section titled “1. Create an Account”

Sign up at data.aleatoric.systems/get-started and choose a plan (Basic, Pro, or Quant). After registration you’ll be redirected to Stripe to complete payment, then your API key will be available on the dashboard.

2. Get Your API Key

Section titled “2. Get Your API Key”

After registration, visit your dashboard to find your API key. Keys are prefixed with ak_live_.

3. Make Your First Request

Section titled “3. Make Your First Request”

JSON-RPC (curl)

Section titled “JSON-RPC (curl)”
Terminal window
curl -X POST https://rpc.aleatoric.systems \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

JSON-RPC (ethers.js)

Section titled “JSON-RPC (ethers.js)”
import { JsonRpcProvider } from 'ethers';


const provider = new JsonRpcProvider('https://rpc.aleatoric.systems', undefined, {
  staticNetwork: true,
  batchMaxCount: 1,
});


// Add API key via custom fetch
const blockNumber = await provider.getBlockNumber();
console.log('Block:', blockNumber);

gRPC (Python)

Section titled “gRPC (Python)”
import grpc
from hypercore_bridge_pb2_grpc import PriceServiceStub
from hypercore_bridge_pb2 import MidPriceRequest


channel = grpc.secure_channel(
    "hl.grpc.aleatoric.systems:443",
    grpc.ssl_channel_credentials(),
)
stub = PriceServiceStub(channel)


response = stub.GetMidPrice(
    MidPriceRequest(coin="BTC"),
    metadata=[("x-api-key", "YOUR_API_KEY")],
)
print(f"BTC mid: {response.price}")

4. Choose Your Region

Section titled “4. Choose Your Region”
  • US (default): rpc.aleatoric.systems, hl.grpc.aleatoric.systems
  • Japan: rpc-jp.aleatoric.systems, jp.grpc.aleatoric.systems

Pro and Quant tiers include access to both regions. See Endpoints for the full list.

Next Steps

Section titled “Next Steps”