The Bridge API provides access to comprehensive data associated with the Bifrost Bridge protocol. With this API, you can retrieve various information, including the transaction history and status of bridge actions and the essential configuration data required to execute bridge actions independently.
The Bifrost Bridge protocol currently supports the following chains:
| Chain Name | Chain ID (testnet chain ID) |
|---|---|
| Bifrost | 3068 (49088) |
| Ethereum | 1 (11155111) |
| BNB | 56 (97) |
| Polygon | 137 ( |
| Base | 8453 (84532) |
| Arbitrum | 42161 (421614) |
✅ All Bridge API endpoints require a X-Network header value which receives either a 'testnet' or 'mainnet' string.
X-Network header value which receives either a 'testnet' or 'mainnet' string.When a Chain ID must be given when using the below endpoints, please double-check that you have matched the right chain ID to the right X-Network value. "Mainnet" chain IDs must be given when "mainnet" is chosen for X-Network and vice-versa.
X-Network value. "Mainnet" chain IDs must be given when "mainnet" is chosen for X-Network and vice-versa.The following endpoints are currently provided:
| Endpoint | Description |
|---|---|
/bridge/config/pair | Get bridge pair list for given source chainId. |
/bridge/config/contract | Get bridge contract information for the given chainId and contractName. |
/bridge/config/chains | Get the list of chains that support bridge actions with their configs. |
/bridge/config/abi | Get Contract ABI Json data for given abiFileName. |
/bridge/action/status | Get the bridge status of the given transaction hash. |
/bridge/action/history/user/{address} | Get the bridge history of the given user address. |
/bridge/action/history/tx/{txHash} | Get the bridge history of the given transaction hash. |
/bridge/action/history/count/{count} | Get count number of the latest bridge history. |
/bridge/action/history (deprecated) | Get the bridge history of the given user address or transaction hash, or get count number of the latest bridge history. |
/bridge/action/encode | Encode given parameters to Bifrost enum. |
/bridge/action/balances | Get bridge token balances of the given account address. |