Bridge API: Cross-Network Token Transfers

The Bridge API lets you move tokens between the networks where they are deployed. A user can hold cNGN on Base and bridge it to BSC, Polygon, Ethereum, or another supported chain. All bridge operations are asynchronous - initiation returns a requestId you can poll with /bridge/status/:requestId, or you can receive a webhook notification at the callbackUrl you provide.

Endpoints Overview

Section	Endpoint	Method	Description
Bridge Quote	`/bridge/quote`	POST	Get the cost, output amount, and validity window for a bridge transaction
Initiate Bridge	`/bridge/initiate`	POST	Start a bridge transaction and receive a funding address
Bridge Status	`/bridge/status/:requestId`	GET	Check the current status of a bridge transaction
Bridge Networks	`/bridge/networks`	GET	List all tokens and networks that support bridging
Bridge History	`/bridge/history`	GET	Retrieve historical bridge transactions with filtering

Bridge Quote

POST /bridge/quote Returns the estimated output amount and fee for bridging cNGN from one network to another. The quote is valid for a limited time window.

The amount field is denominated in human-readable token units. For example, 10000 means 10,000 cNGN.

curl --request POST \
  --url "https://api.strails.io/v1/bridge/quote" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "token": "CNGN",
    "fromNetwork": "base",
    "toNetwork": "bsc",
    "amount": "10000"
  }'

string

required

Token symbol to bridge. Currently CNGN.

string

required

Source network for the bridge. Supported values include base, bsc, eth, pol, asc, arc, celo, sol, and xbn.

string

required

Destination network for the bridge. Use /bridge/networks to see all supported combinations.

string

required

Human-readable amount to bridge (e.g. 10000 = 10,000 cNGN).

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "Bridge quote retrieved",
  "data": {
    "quoteId": "cngn-fallback-1790143588792",
    "provider": "cngn-bridge",
    "token": "CNGN",
    "fromNetwork": "base",
    "toNetwork": "bsc",
    "inputAmount": "10000",
    "outputAmount": "9950.000000",
    "fee": {
      "total": "50.000000",
      "percentage": 0.5,
      "breakdown": {
        "basePercentage": 0.5,
        "networkModifier": 0,
        "finalPercentage": 0.5
      }
    },
    "estimatedDurationSeconds": 210,
    "estimatedDurationMinutes": 4,
    "validUntil": "2026-09-23T06:11:28.792Z"
  }
}

object

Show data fields

string

Unique identifier for this quote.

string

Bridge provider handling the transfer.

string

Token symbol being bridged.

string

Source network.

string

Destination network.

string

Amount sent on the source network.

string

Estimated amount received on the destination network after fees.

object

Show fee fields

string

Total fee deducted from the input amount.

number

Final fee percentage applied.

object

Show breakdown fields

number

Base bridge fee percentage.

number

Network-specific fee modifier.

number

Combined final percentage.

number

Estimated processing time in seconds.

number

Estimated processing time in minutes.

string

ISO 8601 timestamp after which the quote expires.

Initiate Bridge

POST /bridge/initiate Starts a bridge transaction. The response includes a receivableAddress on the source network where the user must send the specified amount. Once the deposit is detected, the bridged tokens are released on the destination network to toAddress.

Funds must originate from fromAddress on the source network. Sending from an unverified address may cause the bridge to fail or require manual reconciliation.

curl --request POST \
  --url "https://api.strails.io/v1/bridge/initiate" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "token": "CNGN",
    "fromNetwork": "base",
    "toNetwork": "bsc",
    "amount": "250",
    "fromAddress": "0xa6affd289C709DA14cAfddCD948fe0043A70F346",
    "toAddress": "0x1843b0A71A716d0bD1F233Af45F451E48a49a2ed",
    "callbackUrl": "https://your.callback.url/v1/bridge/callback"
  }'

string

required

Token symbol to bridge. Currently CNGN.

string

required

Source network for the bridge.

string

required

Destination network for the bridge.

string

required

Human-readable amount to bridge (e.g. 250 = 250 cNGN).

string

required

Wallet address sending the tokens on the source network.

string

required

Destination wallet address on the target network.

string

HTTPS URL where Strails will send webhook notifications for this bridge transaction.

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "Bridge initiated successfully",
  "data": {
    "requestId": "c50ee8f4-ba4a-4a26-97fc-b3daf1909cea",
    "transactionId": "eb01e592-7ab1-45b8-a5a3-c326c817267f",
    "receivableAddress": "0x2a41736e8ea5031ccefb70a913c76c73fc464cf0",
    "reference": "15b2c3fb-37e0-4773-ac48-a01e0225f003",
    "status": "initiated",
    "token": "CNGN",
    "fromNetwork": "base",
    "toNetwork": "bsc",
    "amount": "250",
    "estimatedDurationMinutes": 5,
    "message": "Send 250 CNGN to 0x2a41736e8ea5031ccefb70a913c76c73fc464cf0 on base network. Funds will be bridged to 0x1843b0A71A716d0bD1F233Af45F451E48a49a2ed on bsc."
  }
}

object

Show data fields

string

Unique identifier for tracking the bridge transaction.

string

Internal bridge transaction identifier.

string

Source-network address where the user must send the tokens.

string

Reference code for the bridge transaction.

string

Initial status of the bridge (e.g. initiated).

string

Token symbol being bridged.

string

Source network.

string

Destination network.

string

Amount to send to the receivable address.

number

Estimated processing time in minutes.

string

Human-readable instruction for completing the bridge.

Bridge Status

GET /bridge/status/:requestId Returns the current status of a bridge transaction, including on-chain transaction details and the destination explorer link once completed.

curl --request GET \
  --url "https://api.strails.io/v1/bridge/status/c50ee8f4-ba4a-4a26-97fc-b3daf1909cea" \
  --header "x-api-key: YOUR_API_KEY"

string

required

The requestId returned by /bridge/initiate.

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "Bridge status retrieved",
  "data": {
    "requestId": "c50ee8f4-ba4a-4a26-97fc-b3daf1909cea",
    "status": "completed",
    "token": "CNGN",
    "fromNetwork": "base",
    "toNetwork": "bsc",
    "amount": "250",
    "actualAmount": "150",
    "fromAddress": "0xa6affd289C709DA14cAfddCD948fe0043A70F346",
    "toAddress": "0x1843b0A71A716d0bD1F233Af45F451E48a49a2ed",
    "receivableAddress": "0x2a41736e8ea5031ccefb70a913c76c73fc464cf0",
    "transactionId": "eb01e592-7ab1-45b8-a5a3-c326c817267f",
    "txHash": "0x8e2e3d162911b6f19221a30864b6fc2e87e846c39088cf5a5b841c1826d4a3e2",
    "explorerLink": "https://bscscan.com/tx/0x8e2e3d162911b6f19221a30864b6fc2e87e846c39088cf5a5b841c1826d4a3e2",
    "createdAt": "2026-09-23T06:07:03.872Z",
    "completedAt": "2026-09-23T06:10:25.224Z"
  }
}

object

Show data fields

string

Unique identifier for the bridge transaction.

string

Current status, e.g. initiated, pending, completed, or failed.

string

Token symbol being bridged.

string

Source network.

string

Destination network.

string

Original amount requested for the bridge.

string

Actual amount released on the destination network.

string

Source wallet address.

string

Destination wallet address.

string

Source-network deposit address.

string

Internal bridge transaction identifier.

string

Destination-network transaction hash.

string

Block explorer link for the destination transaction.

string

ISO 8601 timestamp when the bridge was initiated.

string

ISO 8601 timestamp when the bridge completed.

Bridge Networks

GET /bridge/networks Returns the tokens that support bridging and the complete list of networks where bridging is enabled.

curl --request GET \
  --url "https://api.strails.io/v1/bridge/networks" \
  --header "x-api-key: YOUR_API_KEY"

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "All bridge-enabled tokens retrieved",
  "data": {
    "tokens": [
      {
        "token": "CNGN",
        "networks": [
          "base",
          "bsc",
          "eth",
          "sol",
          "pol",
          "atc",
          "lisk",
          "xbn"
        ],
        "preferredProvider": "cngn-bridge"
      }
    ],
    "allSupportedNetworks": [
      "base",
      "bsc",
      "eth",
      "pol",
      "trx",
      "sol",
      "xbn",
      "atc",
      "monad",
      "arc",
      "celo"
    ]
  }
}

object

Show data fields

array

List of bridge-enabled tokens and their supported networks.

array

All networks where bridging is enabled, including token-specific and global availability.

Bridge History

GET /bridge/history Returns a paginated list of historical bridge transactions. Filter by status, token, source network, destination network, date range, and page.

curl --request GET \
  --url "https://api.strails.io/v1/bridge/history?status=completed&token=CNGN&fromNetwork=base&toNetwork=trx&startDate=2026-08-01&endDate=2026-09-23&limit=20&page=1" \
  --header "x-api-key: YOUR_API_KEY"

Available query parameters

Param	Type	Description
`status`	string	Filter by status, e.g. `completed`, `pending`, `failed`
`token`	string	Token ticker, e.g. `CNGN`
`fromNetwork`	string	Source network
`toNetwork`	string	Destination network
`startDate`	ISO date	Start of the date range, e.g. `2026-08-01`
`endDate`	ISO date	End of the date range, e.g. `2026-09-23`
`limit`	number	Page size (default 20)
`page`	number	Page number (default 1)

string

Filter by bridge transaction status.

string

Token ticker, e.g. CNGN.

string

Source network.

string

Destination network.

string

ISO 8601 start of the date range.

string

ISO 8601 end of the date range.

number

Maximum number of results to return. Defaults to 20.

number

Page number for pagination. Defaults to 1.

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "Bridge history retrieved",
  "data": {
    "transactions": [],
    "pagination": {
      "total": 0,
      "limit": 20,
      "offset": 0,
      "hasMore": false
    },
    "filters": {
      "status": "completed",
      "token": "CNGN",
      "fromNetwork": "base",
      "toNetwork": "trx",
      "startDate": "2026-08-01T00:00:00.000Z",
      "endDate": "2026-09-23T00:00:00.000Z"
    },
    "version": "1.0.0"
  }
}

object

Show data fields

array

List of bridge transactions matching the filters.

object

Show pagination fields

number

Total number of matching transactions.

number

Page size.

number

Pagination offset.

boolean

Whether additional pages are available.

object

Filters applied to the query.

string

API version.

Overview

Core APIs

FX & Trading

Configuration

Bridge API: Cross-Network Token Transfers

Endpoints Overview

Bridge Quote

Initiate Bridge

Bridge Status

Bridge Networks

Bridge History

Available query parameters

​Endpoints Overview

​Bridge Quote

​Initiate Bridge

​Bridge Status

​Bridge Networks

​Bridge History

​Available query parameters

Endpoints Overview

Bridge Quote

Initiate Bridge

Bridge Status

Bridge Networks

Bridge History

Available query parameters