Skip to main content
Source code: github.com/agglayer/aggkit

​
Overview

The Bridge Service API is a REST API that provides access to bridge data from AggKit: transaction histories, claim statuses, cryptographic proofs, and network information. It exposes this data through simple HTTP endpoints, removing the need to run and maintain blockchain indexers or proof generation infrastructure. All endpoints follow the pattern: 
{base_url}/bridge/v1/{endpoint}
No authentication is required for most operations.

​
What the API provides

  • Bridge transaction data: Query bridge transactions by address, network, or transaction hash
  • Claim status: Check whether a bridge transaction is ready to claim
  • Proof generation: Retrieve the cryptographic proof required for claim transactions
  • Network information: Access bridge contract addresses and network configuration

​
Quick start

# Check if the API is running
curl "http://localhost:5577/bridge/v1/"

# Get recent bridge transactions on a network
curl "http://localhost:5577/bridge/v1/bridges?network_id=0&page_size=5"

# Get bridges for a specific address
curl "http://localhost:5577/bridge/v1/bridges?network_id=0&from_address=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

# Check for transactions ready to claim
curl "http://localhost:5577/bridge/v1/bridges?network_id=0&from_address=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266&ready_for_claim=true"

# Generate a claim proof
curl "http://localhost:5577/bridge/v1/claim-proof?network_id=0&deposit_count=42&leaf_index=15"

​
Reference

API Reference

All endpoints, parameters, and response formats.