Skip to main content
POST
/
api
/
v1
/
bridge
/
orders
Create bridge order
curl --request POST \
  --url https://api.example.com/api/v1/bridge/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "routeId": "route_base_usdc_01",
  "fromChainId": 1,
  "toChainId": 8453,
  "fromToken": "USDC",
  "toToken": "USDC",
  "amount": "1000",
  "senderAddress": "0xabc1230000000000000000000000000000000000",
  "recipientAddress": "0xabc1230000000000000000000000000000000000"
}
'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "orderId": "bridge_20260511_0001",
    "status": "created",
    "providerKey": "across"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.nexfi.robert.dpdns.org/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json

Bridge order creation request.

​
routeId
string
required

Selected route ID.

Example:

"route_base_usdc_01"

​
fromChainId
integer
required

Source chain ID.

Example:

1

​
toChainId
integer
required

Destination chain ID.

Example:

8453

​
fromToken
string
required

Source asset.

Example:

"USDC"

​
toToken
string
required

Destination asset.

Example:

"USDC"

​
amount
string
required

Bridge amount.

Example:

"1000"

​
senderAddress
string
required

Source wallet address.

Example:

"0xabc1230000000000000000000000000000000000"

​
recipientAddress
string
required

Destination wallet address.

Example:

"0xabc1230000000000000000000000000000000000"

Response

200 - application/json

Order creation response

Standard response envelope.

​
code
integer
required

Business status code. 0 means success.

Example:

0

​
msg
string
required

Human-readable response message.

Example:

"ok"

​
data
object

Initial platform bridge order payload.