Skip to main content

​
Base API URL

All deBridge API requests use the following base URL: 
DEBRIDGE_API = "https://dln.debridge.finance/v1.0"
This is the official API endpoint. Do not use alternative URLs.

​
Core Endpoints

​
Create Bridge Order

Create a cross-chain bridge order for token transfers.
​
endpoint
string
GET /dln/order/create-tx
​
srcChainId
string
required
Source chain ID (e.g., ‘1’ for Ethereum)
​
srcChainTokenIn
string
required
Token address on source chain
​
srcChainTokenInAmount
string
required
Amount to bridge in token’s smallest unit (wei, satoshi, etc.)
​
dstChainId
string
required
Destination chain ID
​
dstChainTokenOut
string
required
Token address on destination chain
​
dstChainTokenOutRecipient
string
required
Recipient address on destination chain
​
dstChainTokenOutAmount
string
Expected output amount. Use “auto” for automatic calculation
​
senderAddress
string
required
Sender’s wallet address
​
srcChainOrderAuthorityAddress
string
Authority address for the order on source chain. Falls back to sender’s address
​
srcChainRefundAddress
string
Address to receive refunds on source chain. Typically the sender’s address
​
dstChainOrderAuthorityAddress
string
Authority address for the order on destination chain. Falls back to recipient’s address
​
referralCode
string
Referral code for the transaction
​
prependOperatingExpenses
boolean
Whether to prepend operating expenses. Recommended to set to true
​
affiliateFeePercent
string
Affiliate fee percentage (e.g., “0.5” for 0.5%). Must be set with affiliateFeeRecipient
​
affiliateFeeRecipient
string
Address to receive affiliate fees. Must be set with affiliateFeePercent
​
dlnHook
string
JSON-stringified hook object for executing actions on the destination chain
​
tx
object
Transaction data ready to be signed and sent
​
data
string
Transaction calldata
​
to
string
Target contract address
​
value
string
Transaction value in wei
​
orderId
string
Unique identifier for the bridge order
​
estimation
object
Estimated amounts and fees for the order

​
Stats API Endpoints

The Stats API is used for tracking order status and retrieving order information.

​
Get Order ID by Transaction Hash

Retrieve the order ID associated with a transaction hash.
​
endpoint
string
GET https://stats-api.dln.trade/api/Transaction/{txHash}/orderIds
​
txHash
string
required
Transaction hash from the source chain
​
orderIds
array
Array of order IDs associated with the transaction

​
Get Order Status by Order ID

Retrieve the current status and details of a bridge order.
​
endpoint
string
GET https://stats-api.dln.trade/api/Orders/{orderId}
​
orderId
string
required
Unique order identifier
​
status
string
Current status of the order (e.g., “Created”, “Fulfilled”, “ClaimedUnlock”)
​
srcChainTx
object
Source chain transaction details
​
dstChainTx
object
Destination chain transaction details (if fulfilled)
​
amount
object
Amount details including input and output amounts

​
Additional Resources

Supported Chains

View all supported chain IDs

Utility Functions

Helper functions for API integration

Build docs developers (and LLMs) love

Get started for freeTalk to us