ETH ↔ PLS Validators
BSC ↔ PLS Validators
Indexer Health
Pending Bridges 0
Completed (24h) 0
Bridge Details
Transaction Details
Validator Details
Documentation
Welcome to the Bridge Status Monitor documentation. Choose a section below to explore the public API, the detailed reference, or step-by-step bridge instructions.
API Documentation
Endpoints, parameters, examples, and event types for consuming the public REST API.
Open API docs →Reference
Contract addresses, event topics, correlation rules, database tables, and status definitions.
Open reference →How To Bridge
Step-by-step instructions for bridging tokens safely using the monitored bridges.
Open how-to →The Bridge Status Monitor exposes a public REST API for querying bridge events, transaction details, validator status, and aggregate statistics. All endpoints return JSON and support CORS.
Base URL
https://bridge-status.g4mm4.io/api
Bridge Types
Replace <type> with one of the supported bridge identifiers.
pls-eth
Official Ethereum ↔ PulseChain bridge
pls-bsc
TokenX BSC ↔ PulseChain bridge
Legacy aliases official (pls-eth) and tokensex (pls-bsc) are still accepted for backward compatibility.
Endpoints
/api/health
Health check. Returns API status and current timestamp.
/api/health/indexer
Indexer health and lag. Returns the latest scanned block per chain and detailed indexer_state rows.
/api/stats
Overall statistics across all monitored bridges, including total pending, completed, and average completion time.
/api/tx/<hash>
Full transaction details for a given transaction hash, including all indexed events, signatures, and lifecycle status.
/api/transaction/<hash>
Raw RPC details for any transaction hash on PulseChain, Ethereum, or BSC. Useful when a transaction is not yet indexed as a bridge event.
/api/address/<address>
All bridge activity for a wallet address, grouped by transaction.
/api/validator/<address>
Find a validator across all bridges and return its metadata, balance, and signature history.
/api/bridge/<type>/status
Bridge statistics: pending count, total requests, total bridged, total signatures, and last indexed block.
/api/bridge/<type>/last-success
The most recently completed bridge transaction for the bridge.
/api/bridge/<type>/recent
Recent bridge events. Optional query parameters:
limit— number of events to return (default 100, max 1000)event_type— filter by event type (e.g.user_request_signature,user_request_affirmation,tokens_bridging_initiated,signed_for_user_request,tokens_bridged,affirmation_completed)
/api/bridge/<type>/pending
Pending bridge requests that have not yet completed.
/api/bridge/<type>/validators
Validator set and observed online/offline status for the bridge.
/api/bridge/<type>/validator/<address>/history
Signature history for a specific validator on a specific bridge.
/api/bridge/<type>/avg-completion-time
24-hour rolling average completion time for the bridge.
Example
curl https://bridge-status.g4mm4.io/api/bridge/pls-eth/status
{
"bridge_type": "pls-eth",
"pending": 42,
"total_requests": 1234,
"total_bridged": 1192,
"total_signatures": 0,
"last_block": 26812000
}
Event Types
user_request_signature AMB home-side user requestuser_request_affirmation AMB foreign-side user requesttokens_bridging_initiated OmniBridge token lock/burn (amount-bearing)signed_for_user_request Validator signature on outgoing requestsigned_for_affirmation Validator affirmation on incoming messagecollected_signatures Enough signatures collected to relaytokens_bridged OmniBridge token mint/unlock completionaffirmation_completed AMB incoming message executedrelayed_message AMB foreign-side incoming message executedfee_distributed OmniBridge fee distribution