📚 API Documentation

BlockScout-compatible REST API for LadyChain blockchain data

Getting Started

Base URL: https://ladyscan.us/api/v2

Format: All responses are in JSON format

Pagination: List endpoints support ?page=N parameter

Rate Limiting: No authentication required, fair use policy applies

Statistics

GET/api/v2/stats

Get network statistics (blocks, transactions, addresses)

GET/api/v2/stats/gas-tracker

Get current gas prices (slow, average, fast)

GET/api/v2/stats/charts

Get chart data (daily transactions, gas prices)

GET/api/v2/stats/top-accounts

Get top 100 richest accounts

Blocks

GET/api/v2/blocks

List all blocks (paginated)

GET/api/v2/blocks/:numberOrHash

Get block details by number or hash

GET/api/v2/main-page/blocks

Get latest 10 blocks for homepage

Transactions

GET/api/v2/transactions

List all transactions (paginated)

GET/api/v2/transactions/:hash

Get transaction details by hash

GET/api/v2/transactions/:hash/logs

Get event logs for transaction

GET/api/v2/transactions/:hash/internal-transactions

Get internal transactions

GET/api/v2/main-page/transactions

Get latest 10 transactions for homepage

Addresses

GET/api/v2/addresses/:address

Get address details and balance

GET/api/v2/addresses/:address/transactions

Get transactions for address

GET/api/v2/addresses/:address/token-balances

Get token holdings for address

GET/api/v2/addresses/:address/token-transfers

Get token transfers for address

Tokens

GET/api/v2/tokens

List all detected tokens (paginated)

GET/api/v2/tokens/:address

Get token details

GET/api/v2/tokens/:address/holders

Get token holder addresses and balances

Smart Contracts

GET/api/v2/smart-contracts/:address/detection-info

Detect contract bytecode and compiler version

POST/api/v2/smart-contracts/verify

Submit contract for verification

GET/api/v2/smart-contracts/:address/verification/status

Check verification status

Search

GET/api/v2/search?q=...

Search for blocks, transactions, or addresses

Example Request

# Get latest blocks
curl https://ladyscan.us/api/v2/blocks
# Response:
{ "items": [ { "number": 33518, "hash": "0x...", "miner": "0x...", "transaction_count": 5, "gas_used": "21000", "timestamp": "2025-11-17T..." } ], "next_page_params": { "page": 2 } }