Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: DLN stats Transaction API
description: '# Introduction
This API is part of deBridge protocol infrastructure.
Protocol documentation is available here.
Terms and Condition | Privacy Policy
# Swagger
Swagger document can be found here
Redoc document can be found here'
version: v1
servers:
- url: https://dln-api.debridge.finance
tags:
- name: Transaction
paths:
/api/Transaction/{orderCreationTransactionHash}/orderIds:
get:
tags:
- Transaction
summary: Returns ids of orders, that were created in a transaction
operationId: Transaction_GetOrdersFromTransaction
parameters:
- name: orderCreationTransactionHash
in: path
description: hash of a transaction the orders were created in
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/OrderIdsDTO'
example:
orderIds:
- bytesValue: AA4r8JSgZRie2pvbP0vsvMKR1Rz9uWFc2cC+A9msUVI=
bytesArrayValue: '[0,14,43,240,148,160,101,24,158,218,155,219,63,75,236,188,194,145,213,28,253,185,97,92,217,192,190,3,217,172,81,82]'
stringValue: '0x000e2bf094a065189eda9bdb3f4becbcc291d51cfdb9615cd9c0be03d9ac5152'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidInputDataResponse'
'422':
description: Unprocessable Content
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
/api/Transaction/{transactionHash}/liteModels:
get:
tags:
- Transaction
summary: Returns lite order models list by order tx hash
operationId: Transaction_GetLiteOrderModel
parameters:
- name: transactionHash
in: path
description: hash of a transaction to search events in
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/OrderLiteDTO'
example:
- orderId:
bytesValue: AA4r8JSgZRie2pvbP0vsvMKR1Rz9uWFc2cC+A9msUVI=
bytesArrayValue: '[0,14,43,240,148,160,101,24,158,218,155,219,63,75,236,188,194,145,213,28,253,185,97,92,217,192,190,3,217,172,81,82]'
stringValue: '0x000e2bf094a065189eda9bdb3f4becbcc291d51cfdb9615cd9c0be03d9ac5152'
creationTimestamp: 0
state: Fulfilled
externalCallState: NoExtCall
makerOrderNonce: 40
makerSrc:
Base64Value: Zj3BXTwaxj/xLkWraP6j8KiDwlE=
bytesArrayValue: '[102,61,193,93,60,26,198,63,241,46,69,171,104,254,163,240,168,131,194,81]'
stringValue: '0x663dc15d3c1ac63ff12e45ab68fea3f0a883c251'
giveOffer:
chainId:
bytesValue: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIk=
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,137]'
bigIntegerValue: 137
stringValue: '137'
tokenAddress:
Base64Value: J5G8ofLeRmHtiKMMmaepRJqoQXQ=
bytesArrayValue: '[39,145,188,161,242,222,70,97,237,136,163,12,153,167,169,68,154,168,65,116]'
stringValue: '0x2791bca1f2de4661ed88a30c99a7a9449aa84174'
amount:
bytesValue: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKNSk=
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,10,53,41]'
bigIntegerValue: 668969
stringValue: '668969'
receiverDst:
Base64Value: sh3+oBDpOfS7DwyzYTUphKjGrA0=
bytesArrayValue: '[178,29,254,160,16,233,57,244,187,15,12,179,97,53,41,132,168,198,172,13]'
stringValue: '0xb21dfea010e939f4bb0f0cb361352984a8c6ac0d'
takeOffer:
chainId:
bytesValue: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAqGo=
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,168,106]'
bigIntegerValue: 43114
stringValue: '43114'
tokenAddress:
Base64Value: AAAAAAAAAAAAAAAAAAAAAAAAAAA=
bytesArrayValue: '[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]'
stringValue: '0x0000000000000000000000000000000000000000'
amount:
bytesValue: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABD7YnoGwAA=
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,16,251,98,122,6,192,0]'
bigIntegerValue: 4780000000000000
stringValue: '4780000000000000'
givePatchAuthoritySrc:
Base64Value: sh3+oBDpOfS7DwyzYTUphKjGrA0=
bytesArrayValue: '[178,29,254,160,16,233,57,244,187,15,12,179,97,53,41,132,168,198,172,13]'
stringValue: '0xb21dfea010e939f4bb0f0cb361352984a8c6ac0d'
orderAuthorityAddressDst:
Base64Value: sh3+oBDpOfS7DwyzYTUphKjGrA0=
bytesArrayValue: '[178,29,254,160,16,233,57,244,187,15,12,179,97,53,41,132,168,198,172,13]'
stringValue: '0xb21dfea010e939f4bb0f0cb361352984a8c6ac0d'
allowedTakerDst:
Base64Value: null
bytesArrayValue: ''
stringValue: null
allowedCancelBeneficiarySrc:
Base64Value: null
bytesArrayValue: ''
stringValue: null
externalCallData: null
extcallExecutionProgress: null
rawOrderMetadataHex: null
referralCode: 2
orderCreationTransactionHash:
stringValue: '0x23c83d7f578c3b54c4b10e884f3e939abca118441ff733a83e62d59b44d70267'
bytesValue: I8g9f1eMO1TEsQ6ITz6TmryhGEQf9zOoPmLVm0TXAmc=
bytesArrayValue: '[35,200,61,127,87,140,59,84,196,177,14,136,79,62,147,154,188,161,24,68,31,247,51,168,62,98,213,155,68,215,2,103]'
orderFulfilledTransactionHash:
stringValue: '0x4af3a086ff58b0d7f2dc69810a52bb53efcbde2ea0081f3222d1b844375af4b7'
bytesValue: SvOghv9YsNfy3GmBClK7U+/L3i6gCB8yItG4RDda9Lc=
bytesArrayValue: '[74,243,160,134,255,88,176,215,242,220,105,129,10,82,187,83,239,203,222,46,160,8,31,50,34,209,184,68,55,90,244,183]'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/InvalidInputDataResponse'
'422':
description: Unprocessable Content
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
components:
schemas:
ExternalCallState:
enum:
- NoExtCall
- AwaitingOrderFulfillment
- AwaitingExecution
- Executing
- Completed
- Failed
- Cancelled
- OrderCancelled
type: string
ErrorResponse:
type: object
properties:
message:
type:
- string
- 'null'
description: Error message
errorCode:
type: integer
description: Error code, if differs from response code (if !=422) indicates unique id of the error that can be used for error's handling automation on client side
format: int32
additionalProperties: false
description: Information about error, occurred in the application
StringPropertyDTO:
type: object
properties:
bytesValue:
type:
- string
- 'null'
description: Binary representation of the property value
format: byte
bytesArrayValue:
type:
- string
- 'null'
description: Bytes array representation of the value
readOnly: true
stringValue:
type:
- string
- 'null'
description: String representation of the property value
readOnly: true
additionalProperties: false
InternalServerErrorResponse:
type: object
properties:
message:
type:
- string
- 'null'
description: Error message
errorCode:
type: integer
description: For this type of error it's always 500
format: int32
additionalProperties: false
description: Information about an internal server error
OrderLiteDTO:
type: object
properties:
orderId:
oneOf:
- $ref: '#/components/schemas/StringPropertyDTO'
- $ref: '#/components/schemas/TransactionHashPropertyDto'
description: Unique identifier of the order
creationTimestamp:
type: integer
description: Timestamp of this event's CreatedOrderSrcEvent's block\slot
format: int64
state:
$ref: '#/components/schemas/OrderState'
externalCallState:
$ref: '#/components/schemas/ExternalCallState'
makerOrderNonce:
type: integer
description: Consecutive unique number of the order for given user in given chain
format: int64
makerSrc:
$ref: '#/components/schemas/AddressPropertyDTO'
giveOffer:
$ref: '#/components/schemas/OfferDTO'
receiverDst:
$ref: '#/components/schemas/AddressPropertyDTO'
takeOffer:
$ref: '#/components/schemas/OfferDTO'
givePatchAuthoritySrc:
$ref: '#/components/schemas/AddressPropertyDTO'
orderAuthorityAddressDst:
$ref: '#/components/schemas/AddressPropertyDTO'
allowedTakerDst:
$ref: '#/components/schemas/AddressPropertyDTO'
allowedCancelBeneficiarySrc:
$ref: '#/components/schemas/AddressPropertyDTO'
externalCallData:
oneOf:
- $ref: '#/components/schemas/StringPropertyDTO'
- $ref: '#/components/schemas/TransactionHashPropertyDto'
description: External call data
extcallExecutionProgress:
$ref: '#/components/schemas/ExtcallExecutionProgressDTO'
rawOrderMetadataHex:
type:
- string
- 'null'
description: Order metadata in hex format
referralCode:
type:
- integer
- 'null'
description: Referral program code
format: int32
orderCreationTransactionHash:
$ref: '#/components/schemas/TransactionHashPropertyDto'
orderFulfilledTransactionHash:
$ref: '#/components/schemas/TransactionHashPropertyDto'
additionalProperties: false
IntPropertyDTO:
type: object
properties:
bytesValue:
type:
- string
- 'null'
description: Binary representation of the property value
format: byte
bytesArrayValue:
type:
- string
- 'null'
description: Bytes array representation of the value
readOnly: true
bigIntegerValue:
type:
- number
- 'null'
description: Integer representation of the property value
format: int64
readOnly: true
stringValue:
type:
- string
- 'null'
description: String representation of the property value
readOnly: true
additionalProperties: false
InvalidInputDataResponse:
type: object
properties:
message:
type:
- string
- 'null'
description: Error message
errorCode:
type: integer
description: For this type of error it's always 400
format: int32
additionalProperties: false
description: Information about bad input params
TransactionHashPropertyDto:
type: object
allOf:
- $ref: '#/components/schemas/StringPropertyDTO'
properties:
stringValue:
type:
- string
- 'null'
description: String representation of the transaction hash value
readOnly: true
additionalProperties: false
description: Transaction Hash property
OrderState:
enum:
- None
- Created
- Fulfilled
- SentUnlock
- OrderCancelled
- SentOrderCancel
- ClaimedUnlock
- ClaimedOrderCancel
type: string
AddressPropertyDTO:
type: object
properties:
Base64Value:
type:
- string
- 'null'
description: Binary representation of the property value
format: byte
bytesArrayValue:
type:
- string
- 'null'
description: Bytes array representation of the value
readOnly: true
stringValue:
type:
- string
- 'null'
description: String representation of the property value
readOnly: true
additionalProperties: false
OrderIdsDTO:
type: object
properties:
orderIds:
type:
- array
- 'null'
items:
oneOf:
- $ref: '#/components/schemas/StringPropertyDTO'
- $ref: '#/components/schemas/TransactionHashPropertyDto'
additionalProperties: false
ExtcallExecutionProgressDTO:
type: object
properties:
executedInstructionsCount:
type: integer
description: 'Indicates how many
ExternalCall instructions were executed
at the time the event occurred'
format: int32
totalInstructionsCount:
type: integer
description: Total number of instructions in the ExternalCall
format: int32
status:
$ref: '#/components/schemas/ExternalCallExecutionStatus'
additionalProperties: false
description: Describes progress of ExternalCall execution
OfferDTO:
type: object
properties:
chainId:
$ref: '#/components/schemas/IntPropertyDTO'
tokenAddress:
$ref: '#/components/schemas/AddressPropertyDTO'
amount:
$ref: '#/components/schemas/IntPropertyDTO'
additionalProperties: false
description: Info about an offer
ExternalCallExecutionStatus:
enum:
- Executed
- FailedToExecute
- Canceled
type: string