Skip to main content
POST
/
api
/
v1
/
bridge
/
execute
bridge-execute
curl --request POST \
  --url https://api.naos.trade/api/v1/bridge/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trade": "<string>",
  "requestId": "<string>",
  "approve": "<string>"
}
'
{
  "success": true,
  "sourceTxHash": "<string>",
  "destinationTxHash": "<string>",
  "requestId": "<string>",
  "trackingUrl": "<string>",
  "bridgeStatus": "<string>",
  "error": "<string>",
  "refundDetails": {
    "currency": "<string>",
    "chain": "<string>",
    "contractAddress": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API key via Authorization: Bearer YOUR_API_KEY

Body

application/json
trade
string
required

Signed deposit transaction (hex for EVM, base64 for Solana)

sourceChain
enum<string>
required

Source chain where the transaction was signed

Available options:
BASE,
ETH,
BSC,
ARB,
AVAX,
ABS,
HYPE,
INK,
STORY,
XLAYER,
PLASMA,
UNI,
MONAD,
MEGAETH,
SOL
requestId
string
required

Request ID from /bridge/quote response

approve
string

Signed approval transaction if provided in quote

Response

200 - application/json

Bridge result — check status field for completion state

success
boolean
required
status
enum<string>

Bridge completion status

Available options:
SUCCESS,
FAILED,
PENDING
sourceTxHash
string | null

Source chain transaction hash

destinationTxHash
string | null

Destination chain transaction hash (present on SUCCESS)

requestId
string | null

Relay request ID for further status polling

trackingUrl
string | null

URL to track bridge status

bridgeStatus
string | null

Raw Relay protocol status (on timeout)

error
string | null
refundDetails
object

Refund information on bridge failure