Transaction

The transaction type represents a single EVM transaction where the 0x Protocol was called.

Example

Query

query Transactions {
  transactions(limit: 2, offset: 100, order_by: {timestamp: desc}, where: {chainName: {_eq: "Ethereum"}}) {
    affiliate
    app
    baseFeePerGas
    blockNumber
    burntGasFees
    burntGasFeesUSD
    calledFunction
    chainName
    feeRecipient
    gasFees
    gasFeesUSD
    gasLimit
    gasPrice
    gasUsed
    hasDirect
    hasLimitOrder
    hasRFQ
    isGasless
    isMultiplex
    isMutihop
    liquiditySource
    maker
    makerAmount
    makerToken
    makerTokenPriceUSD
    makerTokenSymbol
    makerVolumeUSD
    maxFeePerGas
    maxPriorityFeePerGas
    nativeOrderType
    reimbursedGasFees
    reimbursedGasFeesUSD
    router
    taker
    takerAmount
    takerToken
    takerTokenPriceUSD
    takerTokenSymbol
    takerVolumeUSD
    timestamp
    tipGasFees
    tipGasFeesUSD
    transactionFrom
    transactionHash
    transactionTo
    transformerFeeRecipient
    transformerFeeToken
    transformerFeeTokenAmount
    transformerFeeTokenSymbol
    transformerFeeVolumeUSD
    type
    volumeUSD
  }
}

Response

{
  "data": {
    "transactions": [
      {
        "affiliate": "0x86003b044f70dac0abc80ac8957305b6370893ed",
        "app": "Matcha",
        "baseFeePerGas": 24266869553,
        "blockNumber": 15218405,
        "burntGasFees": 5439394543435397,
        "burntGasFeesUSD": 7.57733164136746,
        "calledFunction": "sellTokenForTokenToUniswapV3",
        "chainName": "Ethereum",
        "feeRecipient": null,
        "gasFees": 5815964863435397,
        "gasFeesUSD": 8.10191175375874,
        "gasLimit": 286012,
        "gasPrice": 25946869553,
        "gasUsed": 224149,
        "hasDirect": true,
        "hasLimitOrder": false,
        "hasRFQ": false,
        "isGasless": false,
        "isMultiplex": false,
        "isMutihop": true,
        "liquiditySource": "UniswapV3",
        "maker": null,
        "makerAmount": 226217.48823312,
        "makerToken": "0x2b591e99afe9f32eaa6214f7b7629768c40eeb39",
        "makerTokenPriceUSD": 0.0445926533500708,
        "makerTokenSymbol": "HEX",
        "makerVolumeUSD": 10087.6380345032,
        "maxFeePerGas": 36370000000,
        "maxPriorityFeePerGas": 1680000000,
        "nativeOrderType": null,
        "reimbursedGasFees": 2336334266564603,
        "reimbursedGasFeesUSD": 3.25462317937873,
        "router": "0x API",
        "taker": "0x968f3cbd03a49c1fe7f26dd05a03567fdb21f346",
        "takerAmount": 10000,
        "takerToken": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "takerTokenPriceUSD": 1.00050422571718,
        "takerTokenSymbol": "USDT",
        "takerVolumeUSD": 10005.0422571718,
        "timestamp": "2022-07-26T13:36:48+00:00",
        "tipGasFees": 376570320000000,
        "tipGasFeesUSD": 0.524580112391283,
        "transactionFrom": "0x968f3cbd03a49c1fe7f26dd05a03567fdb21f346",
        "transactionHash": "0x7611ba99504817b44324c73f91f78f77b9b50b472f86824a534f6f4b0828743d",
        "transactionTo": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
        "transformerFeeRecipient": null,
        "transformerFeeToken": null,
        "transformerFeeTokenAmount": null,
        "transformerFeeTokenSymbol": null,
        "transformerFeeVolumeUSD": null,
        "type": 2,
        "volumeUSD": 10005.0422571718
      },
      {
        "affiliate": "0x86003b044f70dac0abc80ac8957305b6370893ed",
        "app": "Matcha",
        "baseFeePerGas": 23121468570,
        "blockNumber": 15218402,
        "burntGasFees": 3150970615251030,
        "burntGasFeesUSD": 4.38944980977262,
        "calledFunction": "sellToUniswap",
        "chainName": "Ethereum",
        "feeRecipient": null,
        "gasFees": 3370379805251030,
        "gasFeesUSD": 4.69509709910195,
        "gasLimit": 164789,
        "gasPrice": 24731468570,
        "gasUsed": 136279,
        "hasDirect": true,
        "hasLimitOrder": false,
        "hasRFQ": false,
        "isGasless": false,
        "isMultiplex": false,
        "isMutihop": false,
        "liquiditySource": "UniswapV2",
        "maker": null,
        "makerAmount": 0.159799731622788,
        "makerToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "makerTokenPriceUSD": 1390.83299487879,
        "makerTokenSymbol": "WETH",
        "makerVolumeUSD": 222.254739313749,
        "maxFeePerGas": 32870000000,
        "maxPriorityFeePerGas": 1610000000,
        "nativeOrderType": null,
        "reimbursedGasFees": 1109110924748970,
        "reimbursedGasFeesUSD": 1.54504352217459,
        "router": "0x API",
        "taker": "0xdfe7ad3e0cc6fb0798e66c67c72927c49fc42478",
        "takerAmount": 43599.216,
        "takerToken": "0xf411903cbc70a74d22900a5de66a2dda66507255",
        "takerTokenPriceUSD": 0.00502070951143715,
        "takerTokenSymbol": "VRA",
        "takerVolumeUSD": 218.898998462403,
        "timestamp": "2022-07-26T13:35:48+00:00",
        "tipGasFees": 219409190000000,
        "tipGasFeesUSD": 0.305647289329335,
        "transactionFrom": "0xdfe7ad3e0cc6fb0798e66c67c72927c49fc42478",
        "transactionHash": "0x039549626e496e41a0c25d463407697ff244794a8be8a4dd5d58a9891224eb7f",
        "transactionTo": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
        "transformerFeeRecipient": null,
        "transformerFeeToken": null,
        "transformerFeeTokenAmount": null,
        "transformerFeeTokenSymbol": null,
        "transformerFeeVolumeUSD": null,
        "type": 2,
        "volumeUSD": 222.254739313749
      }
    ]
  }
}

Code

async function fetchGraphQL(operationsDoc, operationName, variables) {
  const result = await fetch(
    "https://api.0x.org/data/v0",
    {
      method: "POST",
      headers: {
        '0x-api-key': 'USE_APY_KEY_HERE'
      },
      body: JSON.stringify({
        query: operationsDoc,
        variables: variables,
        operationName: operationName
      })
    }
  );

  return await result.json();
}

const operationsDoc = `
  query TransactionsQuery {
    transactions(limit: 2, offset: 100, order_by: {timestamp: desc}, where: {chainName: {_eq: "Ethereum"}}) {
      affiliate
      app
      baseFeePerGas
      blockNumber
      burntGasFees
      burntGasFeesUSD
      calledFunction
      chainName
      feeRecipient
      gasFees
      gasFeesUSD
      gasLimit
      gasPrice
      gasUsed
      hasDirect
      hasLimitOrder
      hasRFQ
      isGasless
      isMultiplex
      isMutihop
      liquiditySource
      maker
      makerAmount
      makerToken
      makerTokenPriceUSD
      makerTokenSymbol
      makerVolumeUSD
      maxFeePerGas
      maxPriorityFeePerGas
      nativeOrderType
      reimbursedGasFees
      reimbursedGasFeesUSD
      router
      taker
      takerAmount
      takerToken
      takerTokenPriceUSD
      takerTokenSymbol
      takerVolumeUSD
      timestamp
      tipGasFees
      tipGasFeesUSD
      transactionFrom
      transactionHash
      transactionTo
      transformerFeeRecipient
      transformerFeeToken
      transformerFeeTokenAmount
      transformerFeeTokenSymbol
      transformerFeeVolumeUSD
      type
      volumeUSD
    }
  }
`;

function fetchTransactionsQuery() {
  return fetchGraphQL(
    operationsDoc,
    "TransactionsQuery",
    {}
  );
}

async function startFetchTransactionsQuery() {
  const { errors, data } = await fetchTransactionsQuery();

  if (errors) {
    // handle those errors like a pro
    console.error(errors);
  }

  // do something great with this precious data
  console.log(data);
}

startFetchTransactionsQuery();