# Bridge API (Token list/Tx Status)

This section explains the Multichain api and how to interact with it. This api organizes data about bridge pairs, router contracts ,tx status and more.

There are two api endpoints you can use:

1. To query token and router contract information.
2. To query cross-chain tx status

### Token Information End point: 

[https://bridgeapi.multichain.org/v4/tokenlistv4/](https://bridgeapi.multichain.org/v4/tokenlistv4/1)[all](https://bridgeapi.multichain.org/v4/tokenlistv4/all)  (new)

<https://bridgeapi.anyswap.exchange/v4/tokenlistv4/all>

{% hint style="info" %}
You can replace "all" with a specific chain id. Such as: <https://bridgeapi.anyswap.exchange/v4/tokenlistv4/1>

Get all chain ids list from this endpoint: <https://bridgeapi.anyswap.exchange/data/bridgeChainInfo>
{% endhint %}

#### Architecture:

Multichain Router has three parts:

* Underlying token address: it's the native token you're bridging.
* anyToken contract: it's a wrapped LP token for the native token, used as a liquidity pool to hold the native token.
* Router contract: The contract you interact with for cross-chain swaps.

Sample Response and Explanation:

```
{
  "chainId" : "chainId", // Source Chain ID
  "address": "address", //  token address
  "name": "name", // token name
  "symbol": "symbol", // token symbol
  "decimals": "decimals", // token decimals
  "price" : "price",  // token price
  "logoUrl" : "logoUrl", // token logo url
  "tokenType": "tokenType", // This is either "NATIVE" for native gas token or "TOKEN" for all other tokens
  "destChains": { // An object with all possible destination chains as keys.
    "chainId": { // Destination Chain ID
      "key": { // Unique hash for each pair
        "address": "address", // Destination token address
        "name": "name", // Destination token name
        "symbol": "symbol", // Destination token symbol
        "decimals": "decimals", // Destination token decimals
        "anytoken": { // Destination anytoken information
          "address": "address", // 
          "symbol": "symbol", // 
          "decimals": "decimals", // 
        },
        "fromanytoken": { // Source Chain anytoken information
          "address": "address", // 
          "symbol": "symbol", // 
          "decimals": "decimals", // 
        },
        "underlying": { // Destination underlying information, if it doesn't exist, return false.
          "address": "address", // 
          "symbol": "symbol", // 
          "decimals": "decimals", // 
        },
        "type": "type", // The type of bridge tx. It would say router for most tokens. And it'd say swapin or swapout for older V2 setup.
        "router": "router", // router address. The address you interace with.
        "tokenid": "tokenid", // tokenid
        "routerABI": "routerABI", // The abi and function you cal to bridge this token.
        "isLiquidity": "isLiquidity", // If liquidity is needed.
        "isApprove": "isApprove", // Is approval needed.
        "isFromLiquidity": "isFromLiquidity", // Is source chain liquidity shown on frontend.
  
        "BigValueThreshold": "BigValueThreshold", // Big value threshold. It'd take longer over this threshold.
        "MaximumSwap": "MaximumSwap", // Maximum amount to bridge
        "MaximumSwapFee": "MaximumSwapFee", // 
        "MinimumSwap": "MinimumSwap", // Minimal amount to bridge. Lower than this won't be processed.
        "MinimumSwapFee": "MinimumSwapFee", // 
        "SwapFeeRatePerMillion": "SwapFeeRatePerMillion", // % of fee. 0.1 means 0.1% fee of the total amount.
  
        "pairid": "pairid", // pairid
        "DepositAddress": "DepositAddress", // Deposit address for older V2 bridge setup.
        "BaseFeePercent": "BaseFeePercent", // Fee percentage for V2 bridge.
        "sortId": "sortId", //
        "chainId": "chainId", // chainId
        "tokenType": "tokenType", // token type.
      }
    }
  }
}
```

### Tx Status Endpoint:

Get transaction status from this API (updated every 5s)&#x20;

<https://scan.multichain.org/#/tx?params=0x8318755719c85110c3c95b635392a380b11c9dd58ae3cedcbc9c5607e3f40df3>

| Code | Status                          |
| ---- | ------------------------------- |
| 0    | Pending                         |
| 3    | ExceedLimit (LessThenMinAmount) |
| 8    | Confirming                      |
| 9    | Swapping                        |
| 10   | Success                         |
| 12   | BigAmount(Wait24hours)          |
| 14   | Failure                         |

## How to integrate the router contract

Please check <https://github.com/anyswap/CrossChain-Router/wiki/How-to-integrate-AnySwap-Router#cross-chain-steps>

### Liquidity Pool Model

Router front-end needs to check the dest chain's underlying token liquidity. If the liquidity of the dest chain is insufficient, users will receive anyUSDC LP token, then user needs to check the balance in the liquidity pool and redeem USDC from the pool when has enough underlying liquidity.

Take USDC as an example, if the user wants to bridge USDC to Fantom, front-end needs to check the underlying USDC balance on anyUSDC(Fantom) contract: <https://ftmscan.com/address/0x95bf7e307bc1ab0ba38ae10fc27084bc36fcd605>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multichain.org/developer-guide/bridge-api-token-list-tx-status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.