Check bridge status

Check bridge status

get

Follow a Hyperliquid deposit or withdrawal through to the destination chain.

Identify the transfer one of two ways:

• request_id — from the bridge quote. The reliable choice for a withdrawal, whose Hyperliquid side produces no origin-chain transaction hash for you to poll.

• tx_hash — the origin-chain transaction hash you broadcast for a deposit. It must be 0x-prefixed; an unprefixed hash is simply never found.

status is normalized to pending, success, failure, refund or not_found. A just-broadcast transfer reads not_found briefly before it is indexed, so treat not_found as retryable for a short bounded window and terminal after that. refund means the funds went back to the origin chain instead of completing. raw_status carries the unnormalized status if you need finer detail.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Query parameters

request_idany ofOptional

request_id from the bridge quote. Preferred for Hyperliquid withdrawals, which have no origin-chain transaction hash to poll.

stringOptional

tx_hashany ofOptional

Origin-chain transaction hash you broadcast for a deposit. Must be 0x-prefixed.

Example: 0x0000000000000000000000000000000000000000000000000000000000000000

stringOptional

Responses

200

Bridge transaction status

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/perp/bridge/status

HTTPcURLJavaScriptPython

GET /api/v1/perp/bridge/status HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Accept: */*

{
  "status": "pending",
  "raw_status": "text",
  "source_tx_hashes": [
    "text"
  ],
  "destination_tx_hashes": [
    "text"
  ],
  "ANY_ADDITIONAL_PROPERTY": "anything"
}