> ## Documentation Index > Fetch the complete documentation index at: https://docs.debridge.com/llms.txt > Use this file to discover all available pages before exploring further. # Get filtered list of orders (ordered by block timestamp desc) max page size: 100 ## OpenAPI ````yaml /dln-details/swagger/monitoring.json post /api/Orders/filteredList openapi: 3.0.1 info: title: DLN stats API description: >- # Introduction This API is part of [deBridge](https://debridge.com/) protocol infrastructure. Protocol documentation is available [here](https://docs.debridge.com/). [Terms and Condition](https://debridge.com/assets/files/debridge_terms_of_service.pdf) | [Privacy Policy](https://debridge.com/assets/files/debridge_privacy_policy.pdf) # Swagger Swagger document can be found [here](/swagger) Redoc document can be found [here](/redoc) version: v1 servers: - url: https://dln-api.debridge.finance security: [] paths: /api/Orders/filteredList: post: tags: - Orders summary: >- Get filtered list of orders (ordered by block timestamp desc) max page size: 100 operationId: Orders_GetOrders requestBody: content: application/json-patch+json: schema: $ref: '#/components/schemas/OrdersRequestDTO' example: 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 application/json: schema: $ref: '#/components/schemas/OrdersRequestDTO' example: 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 text/json: schema: $ref: '#/components/schemas/OrdersRequestDTO' example: 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 application/*+json: schema: $ref: '#/components/schemas/OrdersRequestDTO' example: 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 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/OrdersResponseDTO' example: 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 '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/InvalidInputDataResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' components: schemas: OrdersRequestDTO: type: object properties: giveChainIds: type: array items: type: integer format: int64 description: >- If set, only orders that originated in specified chains will be in the output nullable: true takeChainIds: type: array items: type: integer format: int64 description: >- If set, only orders that have one the specified chains as target chain, will be in the output nullable: true orderStates: type: array items: $ref: '#/components/schemas/OrderState' description: >- If set, only orders that are in specified states, will be in the output nullable: true externalCallStates: type: array items: $ref: '#/components/schemas/ExternalCallState' description: >- If set, only orders that have externalCall in given state, will be in the output nullable: true filter: type: string description: "If set, only orders that have specified filter value as one of the following properties will be in the output\r\nMakerSrc-sender's address\r\nReceiverDst-Receiver's address\r\nGivePatchAuthoritySrc-Address of the wallet that can change value of Give amount in source chain\r\nOrderAuthorityAddressDst-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\r\nAllowedTakerDst-If set, only MM with given address will be able to fulfill the order (i.e. allows creation of orders, targeted at specific MM)\r\nAllowedCancelBeneficiarySrc -Wallet address, if specified, refund after order cancellation will only be allowed to this address\r\nOrderId" nullable: true skip: type: integer description: items to skip (pagination) format: int32 take: type: integer description: Number of items to return (pagination) format: int32 blockTimestampFrom: type: integer description: >- If set, only orders which creations event's Block\slot timestamp is greater or equal to this one will be returned [seconds] format: int64 nullable: true blockTimestampTo: type: integer description: >- If set, only orders which creations event's timestamp is less or equal to this one will be returned [seconds] format: int64 nullable: true fulfiller: type: string description: "If set, only orders that have specified address as fulfiller will be in the output\r\nMultiple 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" nullable: true unlockAuthorities: type: string description: "If set, only orders that have a specified address as unlock authority in destination chain will be in the output\r\nMultiple 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" nullable: true maker: type: string description: "If set, only orders that have specified address as maker will be in the output\r\nMultiple 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" nullable: true creator: type: string description: "If set, only orders that have specified address as initiator of send event\r\nMultiple 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" nullable: true referralCode: type: integer description: >- Referral program code (if set, only orders with that have specified referral in create event will be in the output) format: int32 nullable: true orderAuthorityInSourceChain: type: string description: "If set, only orders that have specified address as order authority in source chain will be in the output\r\nMultiple 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\r\n[hex or base58]" nullable: true orderAuthorityInDestinationChain: type: string description: "If set, only orders that have specified address as order authority in destination chain will be in the output\r\nMultiple 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\r\n[hex or base58]" nullable: true orderTradeType: $ref: '#/components/schemas/OrderTradeType' filterMode: $ref: '#/components/schemas/FilterMode' additionalProperties: false OrdersResponseDTO: type: object properties: orders: type: array items: $ref: '#/components/schemas/OrderListItemDTO' description: Orders from requested page of the search result nullable: true totalCount: type: integer description: Total number of orders fitting the search criteria format: int64 additionalProperties: false InvalidInputDataResponse: type: object properties: message: type: string description: Error message nullable: true errorCode: type: integer description: For this type of error it's always 400 format: int32 additionalProperties: false description: Information about bad input params InternalServerErrorResponse: type: object properties: message: type: string description: Error message nullable: true errorCode: type: integer description: For this type of error it's always 500 format: int32 additionalProperties: false description: Information about an internal server error OrderState: enum: - None - Created - Fulfilled - SentUnlock - OrderCancelled - SentOrderCancel - ClaimedUnlock - ClaimedOrderCancel type: string ExternalCallState: enum: - NoExtCall - AwaitingOrderFulfillment - AwaitingExecution - Executing - Completed - Failed - Cancelled - OrderCancelled type: string OrderTradeType: enum: - None - Market - Limit type: string FilterMode: enum: - CrossChain - SameChain - Mixed type: string description: "Filter mode for orders list\r\n 1. CrossChain - only cross chain orders [default]\r\n 2. SameChain - only same chain orders\r\n 3. Mixed - both cross chain and same chain orders" OrderListItemDTO: type: object properties: orderId: oneOf: - $ref: '#/components/schemas/StringPropertyDTO' - $ref: '#/components/schemas/TransactionHashPropertyDto' description: Unique identifier of the order nullable: true creationTimestamp: type: integer description: Timestamp of this event's CreatedOrderSrcEvent's block\slot format: int64 giveOfferWithMetadata: $ref: '#/components/schemas/OfferWithMetadataDTO' takeOfferWithMetadata: $ref: '#/components/schemas/OfferWithMetadataDTO' state: $ref: '#/components/schemas/OrderState' externalCallState: $ref: '#/components/schemas/ExternalCallState' finalPercentFee: $ref: '#/components/schemas/IntPropertyDTO' fixFee: $ref: '#/components/schemas/IntPropertyDTO' affiliateFee: $ref: '#/components/schemas/AffiliateFeeDTO' unlockAuthorityDst: $ref: '#/components/schemas/AddressPropertyDTO' createEventTransactionHash: $ref: '#/components/schemas/TransactionHashPropertyDto' preswapData: $ref: '#/components/schemas/SwapExecutedEventDTO' orderMetadata: oneOf: - $ref: '#/components/schemas/OrderRawMetadataDTO' - $ref: '#/components/schemas/OrderParsedMetadataDTO' description: Metadata of the order nullable: true tradeType: $ref: '#/components/schemas/TradeType' additionalProperties: false StringPropertyDTO: type: object properties: bytesValue: type: string description: Binary representation of the property value format: byte nullable: true bytesArrayValue: type: string description: Bytes array representation of the value nullable: true readOnly: true stringValue: type: string description: String representation of the property value nullable: true readOnly: true additionalProperties: false TransactionHashPropertyDto: type: object allOf: - $ref: '#/components/schemas/StringPropertyDTO' properties: stringValue: type: string description: String representation of the transaction hash value nullable: true readOnly: true additionalProperties: false description: Transaction Hash property OfferWithMetadataDTO: type: object properties: chainId: $ref: '#/components/schemas/IntPropertyDTO' tokenAddress: $ref: '#/components/schemas/AddressPropertyDTO' amount: $ref: '#/components/schemas/IntPropertyDTO' finalAmount: $ref: '#/components/schemas/IntPropertyDTO' metadata: $ref: '#/components/schemas/MetadataDTO' decimals: type: integer description: Decimals of the token format: int32 name: type: string description: Name of the token nullable: true symbol: type: string description: Symbol of the token nullable: true logoURI: type: string description: Token's logo URI nullable: true additionalProperties: false description: Info about an offer IntPropertyDTO: type: object properties: bytesValue: type: string description: Binary representation of the property value format: byte nullable: true bytesArrayValue: type: string description: Bytes array representation of the value nullable: true readOnly: true bigIntegerValue: type: number description: Integer representation of the property value format: int64 nullable: true readOnly: true stringValue: type: string description: String representation of the property value nullable: true readOnly: true additionalProperties: false AffiliateFeeDTO: type: object properties: beneficiarySrc: $ref: '#/components/schemas/AddressPropertyDTO' amount: $ref: '#/components/schemas/IntPropertyDTO' additionalProperties: false AddressPropertyDTO: type: object properties: Base64Value: type: string description: Binary representation of the property value format: byte nullable: true bytesArrayValue: type: string description: Bytes array representation of the value nullable: true readOnly: true stringValue: type: string description: String representation of the property value nullable: true readOnly: true additionalProperties: false SwapExecutedEventDTO: type: object properties: chainId: $ref: '#/components/schemas/IntPropertyDTO' inTokenAddress: $ref: '#/components/schemas/AddressPropertyDTO' inAmount: $ref: '#/components/schemas/IntPropertyDTO' tokenInMetadata: $ref: '#/components/schemas/MetadataDTO' tokenInLogoURI: type: string description: Logo URI of the token that was used as input of the swap nullable: true readOnly: true outTokenAddress: $ref: '#/components/schemas/AddressPropertyDTO' outAmount: $ref: '#/components/schemas/IntPropertyDTO' tokenOutMetadata: $ref: '#/components/schemas/MetadataDTO' tokenOutLogoURI: type: string description: Logo URI of the token that was received as a result of the swap nullable: true readOnly: true additionalProperties: false OrderRawMetadataDTO: type: object allOf: - $ref: '#/components/schemas/OrderMetadataDTO' properties: rawMetadataHex: type: string nullable: true additionalProperties: false description: Raw order metadata OrderParsedMetadataDTO: type: object allOf: - $ref: '#/components/schemas/OrderMetadataDTO' properties: version: type: integer description: Metadata version format: int32 creationProcessType: $ref: '#/components/schemas/OrderCreationProcessType' origin: $ref: '#/components/schemas/OrderOrigin' additionalTakerIncentiveBps: type: integer description: Additional taker incentive bps format: int32 operatingExpensesAmount: type: string description: >- 20-byte prepended operating expenses amount in input token currency: integer nullable: true recommendedTakeAmount: type: string description: '20-byte recommended take amount in take token currency: integer' nullable: true metadata: type: string description: Order's auxiliary metadata [hex] nullable: true promotionType: $ref: '#/components/schemas/PromotionType' orderTradeType: $ref: '#/components/schemas/OrderTradeType' additionalProperties: false description: Parsed order metadata TradeType: enum: - CrossChain - SameChain type: string MetadataDTO: type: object properties: decimals: type: integer description: Decimals of the token format: int32 name: type: string description: Name of the token nullable: true symbol: type: string description: Symbol of the token nullable: true logoURI: type: string description: URI of the token's logo nullable: true additionalProperties: false description: Token metadata DTO OrderMetadataDTO: type: object additionalProperties: false description: Order metadata base class OrderCreationProcessType: enum: - SrcAmountSet - DstAmountSet - SrcAndDstAmountSet - SrcAndDstAmountSetNoPreswap type: string OrderOrigin: enum: - Default - DeSwap - Dln - DeSwapWidget - DeSwapSolflare - DlnSolflare type: string PromotionType: enum: - None - ArbitrumHorizon - OpHorizon type: string ````