Public API Documentation

Base URL

All API endpoints are relative to this base URL

https://aruscan.com

Statistics

GET/api/stats

Get comprehensive blockchain and network statistics

Example Request

https://aruscan.com/api/stats

Example Response

{
  "totalBlocks": 12345,
  "totalTransactions": 67890,
  "totalAddresses": 1234,
  "network": {
    "height": 12345,
    "currentBlockHash": "0x...",
    "currentDifficulty": "1000000",
    "networkHashrate": "1.23 MH/s",
    "averageDifficulty": "1000000",
    "averageBlockTime": "15.00s",
    "targetBlockTime": "15s",
    "transactionRate": "0.50 tx/s",
    "networkAge": "100 days"
  },
  "gas": {
    "currentGasPrice": "1000000000",
    "currentGasPriceGwei": "1",
    "averageGasUsed": "21000",
    "averageGasLimit": "3141592",
    "gasUsedPercentage": "0.67",
    "totalGasUsed": "210000000"
  },
  "last24h": {
    "blocks": 5760,
    "transactions": 28800,
    "blocksPerHour": "240.00",
    "transactionsPerHour": "1200.00"
  },
  "metrics": {
    "uniqueMiners": 10,
    "averageTransactionsPerBlock": "5.00",
    "totalSupply": "50000000000000000000",
    "totalSupplyFormatted": "50.0"
  },
  "timestamps": {
    "latestBlockTimestamp": 1234567890,
    "latestBlockTime": "2024-01-01T00:00:00.000Z"
  }
}

Try it in browser

GET/api/gas-price

Get current gas price

Example Request

https://aruscan.com/api/gas-price

Example Response

{
  "gasPrice": "1000000000",
  "gasPriceGwei": "1"
}

Try it in browser

Blocks

GET/api/v1/block/{blockNumber}

Get block information by number (standardized format)

Example Request

https://aruscan.com/api/v1/block/12345

Example Response

{
  "status": "success",
  "data": {
    "number": 12345,
    "hash": "0x...",
    "parentHash": "0x...",
    "timestamp": 1234567890,
    "miner": "0x...",
    "difficulty": "1000000",
    "gasUsed": "21000",
    "gasLimit": "3141592",
    "nonce": "0x...",
    "extraData": "",
    "transactionCount": 10,
    "reward": "2000000000000000000"
  }
}

Try it in browser

GET/api/block/{blockNumber}/transactions

Get transactions in a specific block

Example Request

https://aruscan.com/api/block/12345/transactions

Example Response

{
  "transactions": [],
  "total": 10,
  "blockNumber": 12345
}

Try it in browser

Transactions

GET/api/v1/tx/{hash}

Get transaction information by hash (standardized format)

Example Request

https://aruscan.com/api/v1/tx/{hash}

Example Response

{
  "status": "success",
  "data": {
    "hash": "0x...",
    "blockNumber": 12345,
    "blockHash": "0x...",
    "from": "0x...",
    "to": "0x...",
    "value": "1000000000000000000",
    "gasPrice": "1000000000",
    "gasLimit": "21000",
    "gasUsed": "21000",
    "nonce": 0,
    "data": "0x",
    "status": 1,
    "contractAddress": null,
    "timestamp": 1234567890
  }
}

Try it in browser

GET/api/transactions

Get latest transactions

Example Request

https://aruscan.com/api/transactions?page=1&limit=50

Query Parameters

?page=1&limit=50

Example Response

{
  "transactions": [],
  "total": 1000,
  "page": 1,
  "totalPages": 20
}

Try it in browser

Addresses

GET/api/v1/address/{address}

Get address information (standardized format)

Example Request

https://aruscan.com/api/v1/address/0x1234567890123456789012345678901234567890

Example Response

{
  "status": "success",
  "data": {
    "address": "0x...",
    "balance": "1000000000000000000",
    "balanceFormatted": "1.0",
    "transactionCount": 10,
    "isContract": false,
    "firstSeenBlock": 1000,
    "firstSeenTimestamp": 1234567890,
    "lastSeenBlock": 12345,
    "lastSeenTimestamp": 1234567890
  }
}

Try it in browser

GET/api/address/{address}/transactions

Get transactions for a specific address

Example Request

https://aruscan.com/api/address/0x1234567890123456789012345678901234567890/transactions?page=1&limit=25

Query Parameters

?page=1&limit=25

Example Response

{
  "transactions": [],
  "total": 50,
  "page": 1
}

Try it in browser

Miners

GET/api/miners

Get top miners by blocks found

Example Request

https://aruscan.com/api/miners?limit=100

Query Parameters

?limit=100

Example Response

{
  "miners": []
}

Try it in browser

Holders

GET/api/holders

Get top token holders

Example Request

https://aruscan.com/api/holders?limit=100

Query Parameters

?limit=100

Example Response

{
  "holders": []
}

Try it in browser

Rate Limiting

API requests are rate limited to 5 requests per second per IP address.

If you exceed the rate limit, you will receive a 429 Too Many Requests response with a Retry-After header indicating when you can try again.

Progressive Cooldown System:

1st violation: 5 minute cooldown
2nd violation: 10 minute cooldown
3rd violation: 30 minute cooldown
4th violation: 60 minute (1 hour) cooldown
5th+ violation: 24 hour cooldown

Rate limit headers are included in all responses:

X-RateLimit-Limit - Maximum requests per second (5)
X-RateLimit-Remaining - Remaining requests in current window
X-RateLimit-Reset - When the rate limit resets
Retry-After - Seconds to wait before retrying (when rate limited)

Response Format

All API responses are returned in JSON format with appropriate HTTP status codes:

200 OK - Successful request
400 Bad Request - Invalid parameters
404 Not Found - Resource not found
500 Internal Server Error - Server error

Need help? Check out the GitHub repository or join our Discord.