Skip to content

API Overview

The ACDC network exposes multiple API interfaces for interacting with both Alpha and Delta chains. This section provides comprehensive documentation for all available APIs.

Available APIs

API Type Protocol Use Case
JSON-RPC HTTP/HTTPS Standard blockchain queries and transactions
REST HTTP/HTTPS RESTful access to chain data
WebSocket WS/WSS Real-time subscriptions and event streaming

Endpoints

Alpha Chain (UTXO/Privacy)

Network JSON-RPC WebSocket
Mainnet https://alpha-rpc.ac-dc.network wss://alpha-ws.ac-dc.network
Testnet https://alpha-testnet.ac-dc.network wss://alpha-testnet-ws.ac-dc.network

Delta Chain (Account/DeFi)

Network JSON-RPC WebSocket
Mainnet https://delta-rpc.ac-dc.network wss://delta-ws.ac-dc.network
Testnet https://delta-testnet.ac-dc.network wss://delta-testnet-ws.ac-dc.network

Authentication

Public endpoints require no authentication for read operations. Write operations (submitting transactions) are signed client-side and do not require API keys.

For rate-limited access, you can request an API key:

# Request API key (optional, for higher rate limits)
curl -X POST https://api.ac-dc.network/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "developer@example.com"}'

Rate Limits

Tier Requests/sec Daily Limit
Public 10 10,000
Registered 100 100,000
Enterprise Unlimited Unlimited

Response Format

All API responses follow a consistent JSON structure:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": { ... }
}

Error responses include an error object:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request",
    "data": "Additional error details"
  }
}

Next Steps