REST API Documentation

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

All responses are JSON. No authentication required. Rate limit: 100 req/min.

Stats
GET/stats

Network statistics (blocks, txs, validators, rewards, burns)

curl https://ladyscan.us/api/v2/stats
Blocks
GET/blocks

List blocks with pagination (query: limit, offset)

curl "https://ladyscan.us/api/v2/blocks?limit=10&offset=0"
GET/blocks/:number

Get full details for a specific block by number

curl https://ladyscan.us/api/v2/blocks/1
Transactions
GET/transactions

List transactions with pagination (query: limit, offset)

curl "https://ladyscan.us/api/v2/transactions?limit=10&offset=0"
GET/transactions/:hash

Get transaction details by hash

curl https://ladyscan.us/api/v2/transactions/0xYOUR_HASH
GET/transactions/:hash/logs

Get event logs for a transaction

curl https://ladyscan.us/api/v2/transactions/0xYOUR_HASH/logs
GET/transactions/:hash/internal-transactions

Get internal transactions

curl https://ladyscan.us/api/v2/transactions/0xYOUR_HASH/internal-transactions
Addresses
GET/addresses/:address

Get address balance and details

curl https://ladyscan.us/api/v2/addresses/0xYOUR_ADDRESS
GET/addresses/:address/transactions

List transactions for an address

curl "https://ladyscan.us/api/v2/addresses/0xYOUR_ADDRESS/transactions?limit=10"
GET/addresses/:address/token-balances

Token balances for an address

curl https://ladyscan.us/api/v2/addresses/0xYOUR_ADDRESS/token-balances
GET/addresses

Top accounts sorted by balance

curl "https://ladyscan.us/api/v2/addresses?limit=50"
Tokens
GET/tokens

List all tokens

curl https://ladyscan.us/api/v2/tokens
GET/tokens/:address

Token details by contract address

curl https://ladyscan.us/api/v2/tokens/0xYOUR_TOKEN
GET/tokens/:address/transfers

Transfer history for a token

curl https://ladyscan.us/api/v2/tokens/0xYOUR_TOKEN/transfers
Smart Contracts
GET/smart-contracts/:address

Get verified contract source and ABI

curl https://ladyscan.us/api/v2/smart-contracts/0xYOUR_CONTRACT
POST/smart-contracts/:address/verification/via/flattened-code

Verify a contract using flattened Solidity source

curl -X POST https://ladyscan.us/api/v2/smart-contracts/0xYOUR_CONTRACT/verification/via/flattened-code -H "Content-Type: application/json" -d '{"compiler_version":"v0.8.20","source_code":"// SPDX...","contract_name":"MyContract"}'
Search
GET/search?q=:query

Search by address, tx hash, or block number

curl "https://ladyscan.us/api/v2/search?q=0xABCDEF"
Response Format

List endpoints return a paginated object. Single-item endpoints return the resource directly.

// List response { "items": [ ... ], "total": 1842, "next_page_params": { "offset": 25 } } // Stats response { "total_blocks": 1842, "total_txs": 6, "avg_block_time": 2.0, "latest_block": 1842, "total_miner_rewards": "3684000000000000000000", "total_burnt": "924", "active_validators": 1 }
Network Info
Network
LadyChain Mainnet
Chain ID
589
Currency
$LADY
RPC
ladyrpc.us