AERE Network API Documentation
Explore the AERE Network blockchain data through our REST API endpoints
Introduction
The AERE Network Explorer API allows developers to access blockchain data programmatically. The API provides a simple and reliable way to query information about blocks, transactions, accounts, and more.
All API requests should be directed to the base URL:
https://api.aere.network/v1
Authentication
Some API endpoints require authentication via an API key. To obtain an API key, please sign up for an account and generate an API key in your profile settings.
Include your API key as a query parameter or in the request header:
curl https://api.aere.network/v1/blocks?apiKey=YOUR_API_KEY
Rate Limits
Public API: 10 requests per minute
Authenticated API: 60 requests per minute
If you exceed the rate limit, the API will return a 429 Too Many Requests status code.
Account Endpoints
GET
/accounts/{address}
Get account information and balance by address.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| address | string | The account address (0x format) |
Response Example
{
"address": "0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d",
"balance": "1049.28369",
"nonce": 42,
"type": "EOA",
"transactions_count": 128,
"first_activity": "2025-01-15T12:34:56Z",
"last_activity": "2025-04-23T09:18:32Z"
}
cURL
JavaScript
Python
curl -X GET "https://api.aere.network/v1/accounts/0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d"
const response = await fetch('https://api.aere.network/v1/accounts/0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d');
const data = await response.json();
console.log(data);
import requests
response = requests.get('https://api.aere.network/v1/accounts/0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d')
data = response.json()
print(data)
GET
/accounts/{address}/transactions
Get transactions for an account address.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| address | string | The account address (0x format) |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1) |
| limit | integer | Number of results per page (default: 25, max: 100) |
| sort | string | Sort order ('asc' or 'desc', default: 'desc') |
Response Example
{
"total": 128,
"page": 1,
"limit": 25,
"transactions": [
{
"hash": "0x374c823b09e8d83a3c8e1d9d82b78c78de2429db3d5...753c",
"block_number": 596655,
"timestamp": "2025-04-23T09:18:32Z",
"from": "0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d",
"to": "0x3a56e4d2f9f161cd58c5aef43a21f257e2954ed6",
"value": "10.5",
"gas_used": 21000,
"gas_price": "0.000000025",
"status": "success"
},
// ... more transactions
]
}
Block Endpoints
GET
/blocks
Get a list of recent blocks.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1) |
| limit | integer | Number of results per page (default: 25, max: 100) |
Response Example
{
"total": 596839,
"page": 1,
"limit": 25,
"blocks": [
{
"number": 596839,
"hash": "0x8d63e7f28ec3ecf3b9c372589c1e64b47afc861e9c5b2e9f65a23eb87a1b5a18",
"timestamp": "2025-04-23T12:34:56Z",
"transactions_count": 42,
"size": 18240,
"gas_used": 2541987,
"gas_limit": 8000000,
"validator": "0x12facd6a7de552d269cc487e5c47c5ec49f7d6e1",
"difficulty": "3402992",
"total_difficulty": "85192874628609",
"reward": 16.0
},
// ... more blocks
]
}
GET
/blocks/{block_number}
Get information about a specific block by number.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| block_number | integer | The block number |
Response Example
{
"number": 596655,
"hash": "0x8d63e7f28ec3ecf3b9c372589c1e64b47afc861e9c5b2e9f65a23eb87a1b5a18",
"timestamp": "2025-04-23T11:22:33Z",
"transactions_count": 27,
"transactions": ["0x374c823b09e8d83a3c8e1d9d82b78c78de2429db3d5...753c", "0x2e7d9bf52cdd66d5f1a082feda6c4aad102ab37b5b8c5d98437ee56d7de3987a", "..."],
"size": 15640,
"gas_used": 1842987,
"gas_limit": 8000000,
"validator": "0x12facd6a7de552d269cc487e5c47c5ec49f7d6e1",
"difficulty": "3402992",
"total_difficulty": "85192874628609",
"reward": 16.0,
"parent_hash": "0x9c5b2e9f65a23eb87a1b5a18bfd362e7e1107d9a2e7d9bf52cdd66d5f1a082fe",
"sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"nonce": "0x4cb159dd92df1e14"
}
Transaction Endpoints
GET
/transactions/{hash}
Get information about a specific transaction by hash.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| hash | string | The transaction hash (0x format) |
Response Example
{
"hash": "0x374c823b09e8d83a3c8e1d9d82b78c78de2429db3d5...753c",
"block_number": 596655,
"block_hash": "0x8d63e7f28ec3ecf3b9c372589c1e64b47afc861e9c5b2e9f65a23eb87a1b5a18",
"timestamp": "2025-04-23T11:22:33Z",
"from": "0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d",
"to": "0x3a56e4d2f9f161cd58c5aef43a21f257e2954ed6",
"value": "10.5",
"gas": 21000,
"gas_price": "0.000000025",
"gas_used": 21000,
"nonce": 42,
"input": "0x",
"status": "success",
"contract_address": null,
"logs": [],
"transaction_index": 4
}
GET
/transactions
Get a list of recent transactions.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1) |
| limit | integer | Number of results per page (default: 25, max: 100) |
| block_number | integer | Filter by block number (optional) |
Response Example
{
"total": 649007,
"page": 1,
"limit": 25,
"transactions": [
{
"hash": "0x374c823b09e8d83a3c8e1d9d82b78c78de2429db3d5...753c",
"block_number": 596655,
"timestamp": "2025-04-23T11:22:33Z",
"from": "0x7ae46865d2fe763a1cc2b286e6a32e5e65c7c36d",
"to": "0x3a56e4d2f9f161cd58c5aef43a21f257e2954ed6",
"value": "10.5",
"gas_used": 21000,
"gas_price": "0.000000025",
"status": "success"
},
// ... more transactions
]
}
Token Endpoints
GET
/tokens
Get a list of tokens deployed on the AERE Network.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1) |
| limit | integer | Number of results per page (default: 25, max: 100) |
| sort | string | Sort field (e.g., 'market_cap', 'name', 'symbol') |
| order | string | Sort order ('asc' or 'desc', default: 'desc') |
Response Example
{
"total": 128,
"page": 1,
"limit": 25,
"tokens": [
{
"address": "0x3a56e4d2f9f161cd58c5aef43a21f257e2954ed6",
"name": "AERE USD Coin",
"symbol": "aUSDC",
"decimals": 6,
"total_supply": "1000000000.0",
"market_cap": 1000000000,
"price": 1.0,
"holders": 8642,
"transfers": 156842,
"contract_verified": true
},
// ... more tokens
]
}
GET
/tokens/{address}
Get information about a specific token.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| address | string | The token contract address (0x format) |
Response Example
{
"address": "0x3a56e4d2f9f161cd58c5aef43a21f257e2954ed6",
"name": "AERE USD Coin",
"symbol": "aUSDC",
"decimals": 6,
"total_supply": "1000000000.0",
"circulating_supply": "850000000.0",
"market_cap": 1000000000,
"price": 1.0,
"price_change_24h": 0.0,
"holders": 8642,
"transfers": 156842,
"contract_verified": true,
"implementation": null,
"official": true,
"creator": "0x12facd6a7de552d269cc487e5c47c5ec49f7d6e1",
"created_at": "2025-01-15T10:30:00Z",
"creation_transaction": "0x9c5b2e9f65a23eb87a1b5a18bfd362e7e1107d9a2e7d9bf52cdd66d5f1a082fe"
}
Statistics Endpoints
GET
/stats
Get general statistics about the AERE Network.
Response Example
{
"blocks_count": 596839,
"transactions_count": 649007,
"accounts_count": 30628,
"validators_count": 128,
"average_block_time": 39.1,
"gas_price": "22 Gwei",
"latest_block": 596839,
"current_tps": 4.2,
"market_data": {
"price_usd": 5.24,
"market_cap": 228000000,
"volume_24h": 15000000,
"price_change_24h": 2.34,
"circulating_supply": 43543210.88,
"max_supply": 2100000000
},
"burn_data": {
"total_burned": 456789.12,
"burn_rate_24h": 2341.56,
"burn_percentage": 1.05
}
}
GET
/stats/chart
Get historical chart data for various network metrics.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| type | string | Chart type ('transactions', 'price', 'gas', 'hashrate', 'burn') |
| period | string | Time period ('1d', '1w', '1m', '3m', '1y', 'all') (default: '1m') |
Response Example
{
"type": "transactions",
"period": "1m",
"data": [
{
"date": "2025-03-23T00:00:00Z",
"value": 8120
},
{
"date": "2025-03-24T00:00:00Z",
"value": 9450
},
// ... more data points
{
"date": "2025-04-22T00:00:00Z",
"value": 10290
}
]
}