Skip to main content
XOXNO provides three REST services and one WebSocket service. All use JSON encoding and require no authentication.

REST APIs

Each endpoint includes an interactive playground with request builder and live responses. Select an endpoint from the sidebar to try it.

Relayer API

Base URL: https://relayer.xoxno.com
MethodEndpointDescription
POST/v1/broadcastSubmit pre-signed transactions for direct P2P broadcast
POST/v1/signEnterprise: co-sign gasless transactions with the Relayer (V3)
GET/v1/network-stats/historyFetch historical network statistics

Aggregator API

Base URL: https://swap.xoxno.com
MethodEndpointDescription
GET/api/v1/quoteCompute swap routes with ready-to-sign transactions
GET/api/v1/pair-configValidate token pairs and check decimal precision
GET/healthService health check

Gateway API

Base URL: https://rust-gateway.xoxno.com 80 endpoints across 13 categories. The sidebar provides a full interactive playground.
CategoryEndpointsExamples
Address18Account data, balance, ESDT tokens, storage keys
Transaction9Send, simulate, status, pool
Network18Config, economics, token supply, staking
Block5By nonce, by hash, altered accounts
Hyperblock2Cross-shard unified blocks
VM values4Smart contract queries
Validator2Statistics, auction list
Other22Node, proof, internal, status, about

WebSocket API

A full-duplex connection for streaming data and submitting transactions.

subscribe

Subscribe to real-time topics: gas stats, network stats, account deltas, and tx status.

unsubscribe

Remove an active topic subscription.

broadcast

Submit pre-signed transactions for P2P broadcast via WebSocket.

relay

Enterprise: co-sign and broadcast gasless transactions via the Relayer.

Event schemas

The server pushes these payloads to your connection after you subscribe.

gasStats

Per-shard gas prices with percentile breakdowns, every 50 ms.

networkStats

Full network snapshot: TPS, blocks, mempool, validators, health.

accountDelta

Balance and nonce changes for subscribed addresses.

txStatus

Transaction confirmation events with status and optional reason.

Base URLs

ProtocolEndpointPurpose
WebSocketwss://relayer.xoxno.com/wsSubscriptions, broadcast, relay
WebSocketwss://relayer.xoxno.com/ws/statsRead-only network stats stream
RESThttps://relayer.xoxno.comRelayer endpoints
RESThttps://swap.xoxno.comAggregator endpoints
RESThttps://rust-gateway.xoxno.comGateway RPC endpoints