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

• JSON-RPC API Reference - Full RPC method documentation
• REST API Reference - RESTful endpoints
• WebSocket Subscriptions - Real-time event streaming