API Documentation -

API Documentation

Eiquidus-Compatible Blockchain Explorer API

API Overview

This blockchain explorer provides a comprehensive REST API that is fully compatible with the Eiquidus explorer API format. The API supports both single-chain and multi-chain configurations.

Base URL: https://explorer.example.com

Multi-Chain Support

For multi-chain deployments, prefix endpoints with the chain identifier:

# Single chain
GET /api/getblockcount
GET /ext/getmoneysupply

# Multi-chain (replace 'btc' with your chain ID)
GET /btc/api/getblockcount
GET /btc/ext/getmoneysupply

RPC API Endpoints

These endpoints mirror the standard Bitcoin RPC API calls:

Endpoint	Description	Response Type	Example
`/api/getblockcount`	Get the current block height	Plain text (number)	`750000`
`/api/getdifficulty`	Get the current mining difficulty	Plain text (number)	`25046487590083.27`
`/api/getconnectioncount`	Get the number of peer connections	Plain text (number)	`8`
`/api/getblockhash/:height`	Get block hash by height	Plain text (hash)	`000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f`
`/api/getblock/:hash`	Get block information by hash	JSON object	`{"hash": "...", "height": 750000, ...}`
`/api/getrawtransaction/:txid`	Get raw transaction by ID	JSON object	`{"txid": "...", "vin": [...], "vout": [...]}`
`/api/getnetworkhashps`	Get network hash rate per second	Plain text (number)	`150000000000000000000`

Extended API Endpoints

These endpoints provide additional blockchain data and statistics:

Endpoint	Description	Response Type	Parameters
`/ext/getmoneysupply`	Get total coin supply	Plain text (number)	None
`/ext/getaddress/:address`	Get address information and recent transactions	JSON object	`address` - Wallet address
`/ext/getbalance/:address`	Get address balance	Plain text (number)	`address` - Wallet address
`/ext/gettx/:txid`	Get transaction details with confirmations	JSON object	`txid` - Transaction ID
`/ext/getaddresstxs/:address/:start/:length`	Get paginated address transactions	JSON array	`address, start, length` (max 100)
`/ext/getlasttxs/:min/:start?/:length?`	Get recent large transactions	JSON array	`min` - Minimum amount
`/ext/getbasicstats`	Get basic blockchain statistics	JSON object	None
`/ext/getsummary`	Get comprehensive blockchain summary	JSON object	None
`/ext/getnetworkpeers`	Get list of network peers	JSON array	None

Response Examples

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "sent": "0.00000000",
  "received": "50.00000000",
  "balance": "50.00000000",
  "last_txs": [
    {
      "addresses": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
      "type": "vout"
    }
  ]
}

{
  "active": "tx",
  "tx": {
    "txid": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
    "vin": [...],
    "vout": [...],
    "total": "50.00000000",
    "timestamp": 1231006505,
    "blockhash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
    "blockindex": 0
  },
  "confirmations": 750000,
  "blockcount": 750000
}

{
  "difficulty": 25046487590083.27,
  "supply": 19500000,
  "hashrate": 150000000000000000000,
  "lastPrice": 0.00,
  "lastUSDPrice": 0.00,
  "connections": 8,
  "blockcount": 750000,
  "masternodeCountOnline": 0,
  "masternodeCountOffline": 0
}

Rate Limiting & Best Practices

Maximum 100 requests per minute per IP address
Pagination limits: 100 items maximum per request
Use appropriate caching for frequently accessed data
Include proper error handling for 429 (rate limit) responses
Consider using WebSocket connections for real-time data

Error Handling

The API returns standard HTTP status codes and JSON error responses:

Status Code	Description	Response Format
`200`	Success	Requested data
`400`	Bad Request	`{"error": true, "message": "Invalid parameters"}`
`404`	Not Found	`{"error": "Resource not found", "hash": "..."}`
`429`	Rate Limit Exceeded	`{"error": true, "message": "Rate limit exceeded"}`
`500`	Internal Server Error	`{"error": true, "message": "API Error", "details": "..."}`

Need help? This API is fully compatible with existing Eiquidus-based tools and libraries.

For additional support or feature requests, please visit our GitHub repository.