Skip to main content
POST
/
api
/
Orders
/
filteredList
Get filtered list of orders (ordered by block timestamp desc) max page size: 100
curl --request POST \
  --url https://dln-api.debridge.finance/api/Orders/filteredList \
  --header 'Content-Type: application/json-patch+json' \
  --data '{
  "giveChainIds": [
    1,
    137,
    250
  ],
  "takeChainIds": [
    56
  ],
  "orderStates": [
    "Created",
    "Fulfilled"
  ],
  "externalCallStates": [
    "NoExtCall"
  ],
  "filter": "",
  "skip": 0,
  "take": 1,
  "blockTimestampFrom": null,
  "blockTimestampTo": null,
  "fulfiller": null,
  "unlockAuthorities": null,
  "maker": null,
  "creator": null,
  "referralCode": null,
  "orderAuthorityInSourceChain": null,
  "orderAuthorityInDestinationChain": null,
  "orderTradeType": null,
  "filterMode": "CrossChain"
}'
{
  "orders": [
    {
      "orderId": {
        "bytesValue": "LHQS/4QxSDmHwiC+vdMuC07ZvjWfRhAUzF+SOBoy+tU=",
        "bytesArrayValue": "[44,116,18,255,132,49,72,57,135,194,32,190,189,211,46,11,78,217,190,53,159,70,16,20,204,95,146,56,26,50,250,213]",
        "stringValue": "0x2c7412ff8431483987c220bebdd32e0b4ed9be359f461014cc5f92381a32fad5"
      },
      "creationTimestamp": 1758201227,
      "giveOfferWithMetadata": {
        "chainId": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1]",
          "bigIntegerValue": 1,
          "stringValue": "1"
        },
        "tokenAddress": {
          "Base64Value": "oLhpkcYhizbB0Z1KLp6wzjYG60g=",
          "bytesArrayValue": "[160,184,105,145,198,33,139,54,193,209,157,74,46,158,176,206,54,6,235,72]",
          "stringValue": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        },
        "amount": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAESU0iI=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,68,148,210,34]",
          "bigIntegerValue": 1150603810,
          "stringValue": "1150603810"
        },
        "finalAmount": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAESU0iI=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,68,148,210,34]",
          "bigIntegerValue": 1150603810,
          "stringValue": "1150603810"
        },
        "metadata": {
          "decimals": 6,
          "name": "USD Coin",
          "symbol": "USDC",
          "logoURI": "https://tokens.debridge.finance/Logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/big/token-logo.png"
        },
        "decimals": 6,
        "name": "USD Coin",
        "symbol": "USDC",
        "logoURI": "https://tokens.debridge.finance/Logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/big/token-logo.png"
      },
      "takeOfferWithMetadata": {
        "chainId": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADg=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,56]",
          "bigIntegerValue": 56,
          "stringValue": "56"
        },
        "tokenAddress": {
          "Base64Value": "VdOYMm+ZBZ/3dUhSRpmQJ7MZeVU=",
          "bytesArrayValue": "[85,211,152,50,111,153,5,159,247,117,72,82,70,153,144,39,179,25,121,85]",
          "stringValue": "0x55d398326f99059ff775485246999027b3197955"
        },
        "amount": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+JGt7IuIjJ2Q=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,62,36,107,123,34,226,35,39,100]",
          "bigIntegerValue": 1.1463224591676188e+21,
          "stringValue": "1146322459167618705252"
        },
        "finalAmount": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+JGt7IuIjJ2Q=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,62,36,107,123,34,226,35,39,100]",
          "bigIntegerValue": 1.1463224591676188e+21,
          "stringValue": "1146322459167618705252"
        },
        "metadata": {
          "decimals": 18,
          "name": "Tether USD",
          "symbol": "USDT",
          "logoURI": "https://tokens.debridge.finance/Logo/56/0x55d398326f99059ff775485246999027b3197955/big/token-logo.png"
        },
        "decimals": 18,
        "name": "Tether USD",
        "symbol": "USDT",
        "logoURI": "https://tokens.debridge.finance/Logo/56/0x55d398326f99059ff775485246999027b3197955/big/token-logo.png"
      },
      "state": "Fulfilled",
      "externalCallState": "NoExtCall",
      "finalPercentFee": {
        "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAHBok=",
        "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,7,6,137]",
        "bigIntegerValue": 460425,
        "stringValue": "460425"
      },
      "fixFee": {
        "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAONfqTGgAA=",
        "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,141,126,164,198,128,0]",
        "bigIntegerValue": 1000000000000000,
        "stringValue": "1000000000000000"
      },
      "affiliateFee": {
        "beneficiarySrc": {
          "Base64Value": null,
          "bytesArrayValue": "",
          "stringValue": null
        },
        "amount": {
          "bytesValue": null,
          "bytesArrayValue": null,
          "bigIntegerValue": null,
          "stringValue": null
        }
      },
      "unlockAuthorityDst": {
        "Base64Value": "VVziNsAiBpW2g0G8SMaNUiEMw1s=",
        "bytesArrayValue": "[85,92,226,54,192,34,6,149,182,131,65,188,72,198,141,82,33,12,195,91]",
        "stringValue": "0x555ce236c0220695b68341bc48c68d52210cc35b"
      },
      "createEventTransactionHash": {
        "stringValue": "0x35457461f46e620592471a25aa3b3cbe9bc0ae92ca131f6f8a07bb66c6f12059",
        "bytesValue": "NUV0YfRuYgWSRxolqjs8vpvArpLKEx9vige7ZsbxIFk=",
        "bytesArrayValue": "[53,69,116,97,244,110,98,5,146,71,26,37,170,59,60,190,155,192,174,146,202,19,31,111,138,7,187,102,198,241,32,89]"
      },
      "preswapData": {
        "chainId": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1]",
          "bigIntegerValue": 1,
          "stringValue": "1"
        },
        "inTokenAddress": {
          "Base64Value": "2sF/lY0u5SOiIGIGmUWXwT2DHsc=",
          "bytesArrayValue": "[218,193,127,149,141,46,229,35,162,32,98,6,153,69,151,193,61,131,30,199]",
          "stringValue": "0xdac17f958d2ee523a2206206994597c13d831ec7"
        },
        "inAmount": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAESf7xM=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,68,159,239,19]",
          "bigIntegerValue": 1151332115,
          "stringValue": "1151332115"
        },
        "tokenInMetadata": {
          "decimals": 6,
          "name": "Tether USD",
          "symbol": "USDT",
          "logoURI": "https://tokens.debridge.finance/Logo/1/0xdac17f958d2ee523a2206206994597c13d831ec7/big/token-logo.png"
        },
        "tokenInLogoURI": "https://tokens.debridge.finance/Logo/1/0xdac17f958d2ee523a2206206994597c13d831ec7/big/token-logo.png",
        "outTokenAddress": {
          "Base64Value": "oLhpkcYhizbB0Z1KLp6wzjYG60g=",
          "bytesArrayValue": "[160,184,105,145,198,33,139,54,193,209,157,74,46,158,176,206,54,6,235,72]",
          "stringValue": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        },
        "outAmount": {
          "bytesValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAESnbXw=",
          "bytesArrayValue": "[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,68,167,109,124]",
          "bigIntegerValue": 1151823228,
          "stringValue": "1151823228"
        },
        "tokenOutMetadata": {
          "decimals": 6,
          "name": "USD Coin",
          "symbol": "USDC",
          "logoURI": "https://tokens.debridge.finance/Logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/big/token-logo.png"
        },
        "tokenOutLogoURI": "https://tokens.debridge.finance/Logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/big/token-logo.png"
      },
      "orderMetadata": {
        "version": 1,
        "creationProcessType": "SrcAmountSet",
        "origin": "DeSwap",
        "additionalTakerIncentiveBps": 0,
        "operatingExpensesAmount": "2567521",
        "recommendedTakeAmount": "1146322459167618705252",
        "metadata": "0x0000000000000000000000000000000000000000",
        "promotionType": "None",
        "orderTradeType": "Market"
      },
      "tradeType": "CrossChain"
    }
  ],
  "totalCount": 198
}

Body

​
giveChainIds
integer[] | null

If set, only orders that originated in specified chains will be in the output

​
takeChainIds
integer[] | null

If set, only orders that have one the specified chains as target chain, will be in the output

​
orderStates
enum<string>[] | null

If set, only orders that are in specified states, will be in the output

​
externalCallStates
enum<string>[] | null

If set, only orders that have externalCall in given state, will be in the output

​
filter
string | null

If set, only orders that have specified filter value as one of the following properties will be in the output MakerSrc-sender's address ReceiverDst-Receiver's address GivePatchAuthoritySrc-Address of the wallet that can change value of Give amount in source chain OrderAuthorityAddressDst-Address of the wallet that can change value of Take amount (for example reduce it to make order more profitable for the MM) in destination chain or cancel the order AllowedTakerDst-If set, only MM with given address will be able to fulfill the order (i.e. allows creation of orders, targeted at specific MM) AllowedCancelBeneficiarySrc -Wallet address, if specified, refund after order cancellation will only be allowed to this address OrderId

​
skip
integer

items to skip (pagination)

​
take
integer

Number of items to return (pagination)

​
blockTimestampFrom
integer | null

If set, only orders which creations event's Block\slot timestamp is greater or equal to this one will be returned [seconds]

​
blockTimestampTo
integer | null

If set, only orders which creations event's timestamp is less or equal to this one will be returned [seconds]

​
fulfiller
string | null

If set, only orders that have specified address as fulfiller will be in the output Multiple values can be specified at the same time (with space as separator), if many values are specified, result will contain all orders that fit at least one of the criteria

​
unlockAuthorities
string | null

If set, only orders that have a specified address as unlock authority in destination chain will be in the output Multiple values can be specified at the same time (with space as separator), if many values are specified, result will contain all orders that fit at least one of the criteria

​
maker
string | null

If set, only orders that have specified address as maker will be in the output Multiple values can be specified at the same time (with space as separator), if many values are specified, result will contain all orders that fit at least one of the criteria

​
creator
string | null

If set, only orders that have specified address as initiator of send event Multiple values can be specified at the same time (with space as separator), if many values are specified, result will contain all orders that fit at least one of the criteria

​
referralCode
integer | null

Referral program code (if set, only orders with that have specified referral in create event will be in the output)

​
orderAuthorityInSourceChain
string | null

If set, only orders that have specified address as order authority in source chain will be in the output Multiple values can be specified at the same time (with space as separator), if many values are specified, result will contain all orders that fit at least one of the criteria [hex or base58]

​
orderAuthorityInDestinationChain
string | null

If set, only orders that have specified address as order authority in destination chain will be in the output Multiple values can be specified at the same time (with space as separator), if many values are specified, result will contain all orders that fit at least one of the criteria [hex or base58]

​
orderTradeType
enum<string>
Available options:
None,
Market,
Limit
​
filterMode
enum<string>

Filter mode for orders list

  1. CrossChain - only cross chain orders [default]
  2. SameChain - only same chain orders
  3. Mixed - both cross chain and same chain orders
Available options:
CrossChain,
SameChain,
Mixed

Response

OK

​
orders
object[] | null

Orders from requested page of the search result

​
totalCount
integer

Total number of orders fitting the search criteria