Get Requests

This API returns all the cross-chain transactions.

GET /requests/v2

cURL

cURL

curl --request GET \
  --url https://api.relay.link/requests/v2

200

{
  "requests": {
    "id": "0xddd6c1a0340e940b7be4f5a4be076df8b7ec7de7b18f9ec6efe4bfffd2f21cf6",
    "status": "success",
    "user": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
    "recipient": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
    "depositAddress": {
      "address": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
      "depositAddressType": "open",
      "depositor": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea"
    },
    "data": {
      "subsidizedRequest": false,
      "fees": {
        "gas": "2622672522398",
        "fixed": "10000000000000",
        "price": "39000000000000"
      },
      "feesUsd": {
        "gas": "9057",
        "fixed": "34534",
        "price": "134684"
      },
      "inTxs": [
        {
          "fee": "423218878900",
          "data": {
            "to": "0xf70da97812cb96acdf810712aa562db8dfa3dbef",
            "data": "0x5869d8",
            "from": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
            "value": "2651622672522398"
          },
          "hash": "0xe53021eaa63d100b08338197d26953e2219bcbad828267dd936c549ff643aad7",
          "type": "onchain",
          "chainId": 7777777,
          "timestamp": 1713290377
        }
      ],
      "currency": "eth",
      "price": "2600000000000000",
      "usesExternalLiquidity": false,
      "outTxs": [
        {
          "fee": "1837343366480",
          "data": {
            "to": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
            "data": "0x5869d8",
            "from": "0xf70da97812cb96acdf810712aa562db8dfa3dbef",
            "value": "2600000000000000"
          },
          "hash": "0x9da7bc54dfe6229d6980fd62250d472f23dfe0f41a1cdc870c81a08b3445f254",
          "type": "onchain",
          "chainId": 8453,
          "timestamp": 1713290383
        }
      ]
    },
    "moonpayId": "9dc342c3-538b-4731-aba7-13ed89acc7ae",
    "createdAt": "2024-04-16T17:59:39.702Z",
    "updatedAt": "2024-04-16T17:59:46.145Z"
  },
  "continuation": "<string>"
}

Query Parameters

limit · number · default: 20

Required range: 1 <= x <= 50

continuation · string

user · string

hash · string

originChainId · number

destinationChainId · number

privateChainsToInclude · string

id · string

orderId · string

includeOrderData · boolean

startTimestamp · number

endTimestamp · number

startBlock · number

endBlock · number

chainId · string

Get all requests for a single chain in either direction. Setting originChainId and/or destinationChainId will override this parameter.

referrer · string

depositAddress · string

Filter requests by deposit address. Returns all requests associated with this deposit address.

includeChildRequests · boolean

When filtering by id or depositAddress, also return child transactions (e.g. duplicates, retries, refunds) linked to the original request.

status · enum<string>

Filter requests by status.

Available options: success, failure, refund, pending, depositing

apiKey · string

Filter requests by the API key that created them.

sortBy · enum<string> · default: createdAt

Available options: createdAt, updatedAt

sortDirection · enum<string>

Available options: asc, desc

Response

200 - application/json

Default Response

requests · object[]

Show child attributes

Example:

{
  "id": "0xddd6c1a0340e940b7be4f5a4be076df8b7ec7de7b18f9ec6efe4bfffd2f21cf6",
  "status": "success",
  "user": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
  "recipient": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
  "depositAddress": {
    "address": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
    "depositAddressType": "open",
    "depositor": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea"
  },
  "data": {
    "subsidizedRequest": false,
    "fees": {
      "gas": "2622672522398",
      "fixed": "10000000000000",
      "price": "39000000000000"
    },
    "feesUsd": {
      "gas": "9057",
      "fixed": "34534",
      "price": "134684"
    },
    "inTxs": [
      {
        "fee": "423218878900",
        "data": {
          "to": "0xf70da97812cb96acdf810712aa562db8dfa3dbef",
          "data": "0x5869d8",
          "from": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
          "value": "2651622672522398"
        },
        "hash": "0xe53021eaa63d100b08338197d26953e2219bcbad828267dd936c549ff643aad7",
        "type": "onchain",
        "chainId": 7777777,
        "timestamp": 1713290377
      }
    ],
    "currency": "eth",
    "price": "2600000000000000",
    "usesExternalLiquidity": false,
    "outTxs": [
      {
        "fee": "1837343366480",
        "data": {
          "to": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
          "data": "0x5869d8",
          "from": "0xf70da97812cb96acdf810712aa562db8dfa3dbef",
          "value": "2600000000000000"
        },
        "hash": "0x9da7bc54dfe6229d6980fd62250d472f23dfe0f41a1cdc870c81a08b3445f254",
        "type": "onchain",
        "chainId": 8453,
        "timestamp": 1713290383
      }
    ]
  },
  "moonpayId": "9dc342c3-538b-4731-aba7-13ed89acc7ae",
  "createdAt": "2024-04-16T17:59:39.702Z",
  "updatedAt": "2024-04-16T17:59:46.145Z"
}

continuation · string