Tracking Orders via API

Once an order has been successfully created on-chain, its state can be monitored using several available methods, depending on the use case. For a full overview of order states and their transitions, refer to the Order States documentation.

Key Completion States

Orders progress through multiple internal states. However, from the perspective of the end-user experience, the following states indicate successful completion:

Fulfilled
SentUnlock
ClaimedUnlock

Any of these states can be treated as successfully completed final states for application-level logic.

Quick Start

Base URL: https://dln-api.debridge.finance
Full endpoint reference: Swagger
Examples: See the implementation examples in this GitHub repository.

Querying Orders

By Wallet Address

The POST /api/Orders/filteredList endpoint retrieves the current state and historical data for all orders associated with a wallet address. This endpoint is also used to populate the trade history view in deExplorer. Pagination is supported via skip and take parameters.

Example: Fetching Completed Orders for a Wallet

const URL = 'https://dln-api.debridge.finance/api/Orders/filteredList';

const requestBody = {
  orderStates: ['Fulfilled', 'SentUnlock', 'ClaimedUnlock'],
  externalCallStates: ['NoExtCall'],
  skip: 0,
  take: 10,
  maker: '0x441bc84aa07a71426f4d9a40bc40ac7183d124b9',
};

const data = await post(URL, requestBody);

Example: Filtering Completed Orders by Destination Chain (e.g. HyperEVM)

const requestBody = {
  giveChainIds: [],
  takeChainIds: [100000022], // Internal HyperEVM Chain Id
  orderStates: ['Fulfilled', 'SentUnlock', 'ClaimedUnlock'],
  externalCallStates: ['NoExtCall'],
  skip: 0,
  take: 10,
  maker: '0x441bc84aa07a71426f4d9a40bc40ac7183d124b9',
};

By `referralCode`

Orders created through specific integrations can also be tracked by using the referralCode parameter attached to each API request.

  const requestBody = {
    giveChainIds: [],
    // All of these are considered to be fulfilled 
    // from the end-user's perspective
    orderStates: ['Fulfilled', 'SentUnlock', 'ClaimedUnlock' ],
    externalCallStates: ['NoExtCall'],
    skip: 0,
    take: 3,
    referralCode: "31805",
  };

By Transaction Hash

For inspecting a specific order, use:

GET /api/Orders/creationTxHash/{hash}

Example:

https://dln-api.debridge.finance/api/Orders/creationTxHash/ 0x3fe11542154f53dcf3134eacb30ea5ca586c9e134c223e56bbe1893862469bc5

If multiple orders were created in a single transaction, this endpoint returns data only for the first order.

Multiple Orders Created in the Same Transaction

To retrieve all order IDs:

GET /api/Transaction/{hash}/orderIds

Example:

https://dln-api.debridge.finance/api/Transaction/ 0x40ee524d5bb9c4ecd8e55d23c66c5465a3f137be7ae24df366c3fd06daf7de7e /orderIds

Response:

{
  "orderIds": [
    "0x9ee6c3d0aa68a7504e619b02df7c71539d0ce10e27f593bf8604b62e51955a01"
  ]
}

Example:

export async function getOrderIdByTransactionHash(txHash: string) {
  const URL = `https://dln-api.debridge.finance/api/Transaction/${txHash}/orderIds`;

  const response = await fetch(URL);
  if (!response.ok) {
    const errorText = await response.text();
    throw new Error(`Failed to get orderIds: ${response.statusText}. ${errorText}`);
  }

  const data = await response.json();
  if (data.error) {
    throw new Error(`DeBridge API Error: ${data.error}`);
  }

  return data;
}

By `orderId`

Use this endpoint:

GET /api/Orders/{orderId}

Example:

https://dln-api.debridge.finance/api/Orders/ 0x9ee6c3d0aa68a7504e619b02df7c71539d0ce10e27f593bf8604b62e51955a01

Response:

{
  "status": "ClaimedUnlock"
}

Example:

export async function getOrderStatusByOrderId(orderId: string) {
  const URL = `https://dln-api.debridge.finance/api/Orders/${orderId}`;

  const response = await fetch(URL);
  if (!response.ok) {
    const errorText = await response.text();
    throw new Error(`Failed to get order status: ${response.statusText}. ${errorText}`);
  }

  const data = await response.json();
  if (data.error) {
    throw new Error(`DeBridge API Error: ${data.error}`);
  }

  return data;
}

Order Fulfillment Transaction

When order fulfillment transactions are important in the integration, they can be found inside of an each order returned by the API by referencing the fulfilledDstEventMetadata.transactionHash field.

Affiliate Fee Settlement

If set during order creation, the affiliate fee is automatically transferred to the affiliateFeeRecipient once the order reaches the ClaimedUnlock status on EVM-based chains, and on Solana it is manually withdrawable.

Order Tracking API

AnnouncementBanner

OrderEvents

Orders

ReferralProgram

SameChainSwap

Satistics

TermsAndConditions

TokenMetadata

Transaction

Users

Tracking Orders

Tracking Orders via API

Key Completion States

Quick Start

Querying Orders

By Wallet Address

Example: Fetching Completed Orders for a Wallet

Example: Filtering Completed Orders by Destination Chain (e.g. HyperEVM)

By `referralCode`

By Transaction Hash

Multiple Orders Created in the Same Transaction

Example:

By `orderId`

Example:

Order Fulfillment Transaction

Affiliate Fee Settlement

​Tracking Orders via API

​Key Completion States

​Quick Start

​Querying Orders

​By Wallet Address

​Example: Fetching Completed Orders for a Wallet

​Example: Filtering Completed Orders by Destination Chain (e.g. HyperEVM)

​By referralCode

​By Transaction Hash

​Multiple Orders Created in the Same Transaction

​Example:

​By orderId

​Example:

​Order Fulfillment Transaction

​Affiliate Fee Settlement

Tracking Orders via API

Key Completion States

Quick Start

Querying Orders

By Wallet Address

Example: Fetching Completed Orders for a Wallet

Example: Filtering Completed Orders by Destination Chain (e.g. HyperEVM)

By `referralCode`

By Transaction Hash

Multiple Orders Created in the Same Transaction

Example:

By `orderId`

Example:

Order Fulfillment Transaction

Affiliate Fee Settlement