Skip to main content
GET
/
requests
/
v2
cURL
curl --request GET \
  --url https://api.relay.link/requests/v2
{
  "requests": {
    "id": "0xddd6c1a0340e940b7be4f5a4be076df8b7ec7de7b18f9ec6efe4bfffd2f21cf6",
    "status": "success",
    "user": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
    "recipient": "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
​
sortBy
enum<string>
default:createdAt
Available options:
createdAt,
updatedAt
​
sortDirection
enum<string>
Available options:
asc,
desc

Response

200 - application/json

Default Response

​
requests
object[]
Example:
{
  "id": "0xddd6c1a0340e940b7be4f5a4be076df8b7ec7de7b18f9ec6efe4bfffd2f21cf6",
  "status": "success",
  "user": "0x456bccd1eaa77d5cc5ace1723b5dcca00d67cdea",
  "recipient": "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