API Documentation
All endpoints accept POST to api.php
Base URL
POST /basescan_link/api.php
// Send action parameter with each request
// Send action parameter with each request
Usage Example
// JavaScript
const fd = new FormData();
fd.append('action', 'base_ticker');
const r = await fetch('api.php', {method:'POST', body:fd});
const data = await r.json();
const fd = new FormData();
fd.append('action', 'base_ticker');
const r = await fetch('api.php', {method:'POST', body:fd});
const data = await r.json();
Endpoints
POST ping Public
Health check: returns server status, PHP version, cURL availability.
| Param | Type | Required | Description |
|---|---|---|---|
| No parameters | |||
// Response
{"status":"success","ok":true,"php":"8.x","curl":true,"time":1725372000,"chain_id":8453}
{"status":"success","ok":true,"php":"8.x","curl":true,"time":1725372000,"chain_id":8453}
POST base_ticker Public
Live ticker: ETH price, gas price (Gwei), latest block number. Cached 4s.
| Param | Type | Required | Description |
|---|---|---|---|
| No parameters | |||
{"status":"success","block_number":12345678,"gas_gwei":0.0042,"eth_price_usd":3500.12,"chain_id":8453}
POST base_status Public
Network status: latest block, gas price in wei and Gwei.
| Param | Type | Required | Description |
|---|---|---|---|
| No parameters | |||
POST base_get_tx Public
Fetch transaction detail by hash, including receipt (status, gas used, logs).
| Param | Type | Required | Description |
|---|---|---|---|
hash | string | Yes | Transaction hash (0x...64 hex). Aliases: digest, tx |
POST base_get_block Public
Fetch block detail by number with full transaction list.
| Param | Type | Required | Description |
|---|---|---|---|
n | int | Yes | Block number. Alias: block |
POST base_address_txs Public
Paginated transaction history for an address (via BaseScan API).
| Param | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Base address (0x...) |
page | int | No | Page number (default 1) |
limit | int | No | Results per page (10-50, default 25) |
POST base_search Public
Universal search: detects address, tx hash, or block number and returns redirect URL.
| Param | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query |
{"status":"success","type":"address","id":"0x...","url":"address.php?a=0x..."}
POST base_explorer_pass Auth
Create a pass token for authorized address lookup (AI Wallet bridge).
| Param | Type | Required | Description |
|---|---|---|---|
secret_phrase | string | Yes | User secret phrase |
address | string | Yes | Base address |
POST base_explorer_lookup Auth
Full address lookup with on-chain data + wallet ledger. Requires valid pass token or secret.
| Param | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Base address |
asset | string | No | Asset filter (default: all) |
k | string | Conditional | Pass token (alternative to secret_phrase) |
secret_phrase | string | Conditional | User secret |
Rate Limits: Public endpoints: 60 req/min. Auth endpoints: 30 req/min per token.
BasePulse API - Base Mainnet (Chain ID 8453) - ETH native token