Check cross-chain bridge status

Check cross-chain bridge status

get

Check the status of a cross-chain bridge transaction started via the trading execute endpoint.

Pass the source-chain transaction hash from the execute response, plus the source and destination chains of the swap.

Aggregator: pass the aggregator field from the quote you executed. Status checks default to lifi, and Relay transactions are not found under that default — always set aggregator=relay for Relay bridges.

Authorizations

apikeystringRequired

API key for authentication

Query parameters

tx_hashstringRequired

Source-chain transaction hash returned by the execute endpoint

Example: 0x36b0c44ea57f060febbec537ff6c70e3c8f1a5ffdfd82f7335edb270b35478b6

from_chainstring · enumRequired

Source chain: 'solana' or 'base'

Example: basePossible values:

to_chainstring · enumRequired

Destination chain: 'solana' or 'base'

Example: solanaPossible values:

aggregatorany ofOptional

Aggregator that produced the executed quote ('lifi' or 'relay'), as returned in the quote response. Status checks default to 'lifi', and Relay transactions are not found under that default — always pass this for Relay bridges.

string · enumOptionalPossible values:

Responses

200

Bridge transaction status including sending and receiving details

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

get/api/v1/trade/bridge-status

GET /api/v1/trade/bridge-status?tx_hash=0x36b0c44ea57f060febbec537ff6c70e3c8f1a5ffdfd82f7335edb270b35478b6&from_chain=base&to_chain=solana HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Accept: */*

{
  "status": "text",
  "substatus": "text",
  "ANY_ADDITIONAL_PROPERTY": "anything"
}