API Reference

Overview

  • Example 1: Latest token transfers made by a wallet
  • Example 2: Latest DEX trades for multiple tokens
  • Example 3: All blocks between a time period

Example 1: Latest token transfers made by a wallet

Request

https://api.syve.ai/v1/filter-api/erc20?eq:from_address=0x004baeac693aac11dcd1d7139338d32fbd87898a&size=5&sort=desc

The above request returns the 5 most recent token transfers made by wallet 0x004baeac693aac11dcd1d7139338d32fbd87898a.

Response

[
   {
      "record_index":8117208800000243,
      "transaction_hash":"0x99fd0d62c4ca824dee85106f41be64e2fac531f7ce88f5b72463a65a2555a247",
      "transaction_index":88,
      "block_number":20293022,
      "timestamp":1720818599,
      "from_address":"0x004baeac693aac11dcd1d7139338d32fbd87898a",
      "to_address":"0xa9b4192cdcc38ffb5201793c3266b6216c02d371",
      "token_address":"0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
      "token_symbol":"LRC",
      "token_name":"LoopringCoin V2",
      "log_index":243,
      "value_base":"213690857000000000000000",
      "value_token":213690.857
   },
   {
      "record_index":8091986000000219,
      "transaction_hash":"0x44ece669f44812ceb5b34641805e2bdb9b48294d8fd125244c32be0f161a7a72",
      "transaction_index":34,
      "block_number":20229965,
      "timestamp":1720057679,
      "from_address":"0x004baeac693aac11dcd1d7139338d32fbd87898a",
      "to_address":"0x71fbc592c89a7798d59ff76bb70966d3f437aa86",
      "token_address":"0xff20817765cb7f73d4bde2e66e067e58d11095c2",
      "token_symbol":"AMP",
      "token_name":"Amp",
      "log_index":219,
      "value_base":"71627009000000000000000",
      "value_token":71627.009
   },
   {
      "record_index":8091958800000358,
      "transaction_hash":"0x32094654daee3b84fd5b7a7d8b43f1797dd4d17d3856d123ef561d4a83f826a9",
      "transaction_index":94,
      "block_number":20229897,
      "timestamp":1720056863,
      "from_address":"0x004baeac693aac11dcd1d7139338d32fbd87898a",
      "to_address":"0x22f9dcf4647084d6c31b2765f6910cd85c178c18",
      "token_address":"0x1ceb5cb57c4d4e2b2433641b95dd330a33185a44",
      "token_symbol":"KP3R",
      "token_name":"Keep3rV1",
      "log_index":358,
      "value_base":"1098500000000000000",
      "value_token":1.0985
   },
   {
      "record_index":8091942000000119,
      "transaction_hash":"0x8db3f4ab1d861c0b04856b9bc3587285bedcad02b3678a8ccd459f43a2e3f5e8",
      "transaction_index":32,
      "block_number":20229855,
      "timestamp":1720056359,
      "from_address":"0x004baeac693aac11dcd1d7139338d32fbd87898a",
      "to_address":"0xe37e799d5077682fa0a244d46e5649f71457bd09",
      "token_address":"0xa0246c9032bc3a600820415ae600c6388619a14d",
      "token_symbol":"FARM",
      "token_name":"FARM Reward Token",
      "log_index":119,
      "value_base":"998300000000000000",
      "value_token":0.9983
   },
   {
      "record_index":8091932800000271,
      "transaction_hash":"0x394ce01371e0fecdfe6d776f2870bad3c26436189674ae296e72e985abd14d6b",
      "transaction_index":108,
      "block_number":20229832,
      "timestamp":1720056083,
      "from_address":"0x004baeac693aac11dcd1d7139338d32fbd87898a",
      "to_address":"0xe37e799d5077682fa0a244d46e5649f71457bd09",
      "token_address":"0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b",
      "token_symbol":"DPI",
      "token_name":"DefiPulse Index",
      "log_index":271,
      "value_base":"39547500000000000000",
      "value_token":39.5475
   }
]

Example 2: Latest DEX trades for multiple tokens

Request

https://api.syve.ai/v1/filter-api/dex-trades?eq:token_address=0x226f7b842e0f0120b7e194d05432b3fd14773a9d,0x37236cd05b34cc79d3715af2383e96dd7443dcf1&size=5&sort=desc

It is possible to filter according to multiple matches in a single request by providing a comma separated string. The above request retrieves the latest price information two tokens: 0x226f7b842e0f0120b7e194d05432b3fd14773a9d and 0x37236cd05b34cc79d3715af2383e96dd7443dcf1.

Response

[
  {
    "block_number": 17803620,
    "timestamp": 1690693151,
    "transaction_hash": "0x8129415510e1f1dc48112ea59a505e651e6e02413c550f1915a6db66960801a3",
    "token_address": "0x226f7b842e0f0120b7e194d05432b3fd14773a9d",
    "price_token_usd_tick_1": 0.0002557661306061598,
    "price_token_usd_tick_100": 0.0002557661306061598,
    "price_token_usd_wavg_1h": null,
    "price_token_usd_wavg_24h": null,
    "volume_1h_usd": 1292.8678027211458,
    "volume_24h_usd": 1292.8678027211458,
    "num_trades_1h": 2,
    "num_trades_24h": 2,
    "protocol_name": "uniswap_v2",
    "pool_address": "0x7f1da3697236d4a5e0efd2a99de5d9c076937856",
    "side": "buy",
    "amount_token": 719726.554171208,
    "amount_eth": 0.09795080081427661,
    "amount_usd": 184.08167585487448
  },
  {
    "block_number": 17803619,
    "timestamp": 1690693139,
    "transaction_hash": "0x8af885cad1563cde1b5ac0d7cd1915358ce0885e2c6b2558a51de7d6858645b6",
    "token_address": "0x226f7b842e0f0120b7e194d05432b3fd14773a9d",
    "price_token_usd_tick_1": 0.0002598774182162312,
    "price_token_usd_tick_100": 0.0002598774182162312,
    "price_token_usd_wavg_1h": null,
    "price_token_usd_wavg_24h": null,
    "volume_1h_usd": 1108.7835592829442,
    "volume_24h_usd": 1108.7835592829442,
    "num_trades_1h": 1,
    "num_trades_24h": 1,
    "protocol_name": "uniswap_v2",
    "pool_address": "0x7f1da3697236d4a5e0efd2a99de5d9c076937856",
    "side": "sell",
    "amount_token": 4266563.701046083,
    "amount_eth": 0.589990766619998,
    "amount_usd": 1108.7835592829442
  },
  {
    "block_number": 17787621,
    "timestamp": 1690499807,
    "transaction_hash": "0x3eac2601b00623a96b4babbe6a7cd38974c6e49ea6854fcbc6ee3658e2bf131a",
    "token_address": "0x226f7b842e0f0120b7e194d05432b3fd14773a9d",
    "price_token_usd_tick_1": 0.0002635073202162539,
    "price_token_usd_tick_100": 0.0002635073202162539,
    "price_token_usd_wavg_1h": null,
    "price_token_usd_wavg_24h": null,
    "volume_1h_usd": 2362.9502497272583,
    "volume_24h_usd": 2362.9502497272583,
    "num_trades_1h": 2,
    "num_trades_24h": 2,
    "protocol_name": "uniswap_v2",
    "pool_address": "0x7f1da3697236d4a5e0efd2a99de5d9c076937856",
    "side": "buy",
    "amount_token": 1102965.4037088084,
    "amount_eth": 0.15644213935236712,
    "amount_usd": 290.6394578225468
  },
  {
    "block_number": 17787621,
    "timestamp": 1690499807,
    "transaction_hash": "0xe6d43b08afb2a9a82abce0b1d29c0977404bda65d759758d7f31493e8dfcdc24",
    "token_address": "0x226f7b842e0f0120b7e194d05432b3fd14773a9d",
    "price_token_usd_tick_1": 0.0002730150600868833,
    "price_token_usd_tick_100": 0.0002730150600868833,
    "price_token_usd_wavg_1h": null,
    "price_token_usd_wavg_24h": null,
    "volume_1h_usd": 2362.9502497272583,
    "volume_24h_usd": 2362.9502497272583,
    "num_trades_1h": 2,
    "num_trades_24h": 2,
    "protocol_name": "uniswap_v2",
    "pool_address": "0x7f1da3697236d4a5e0efd2a99de5d9c076937856",
    "side": "sell",
    "amount_token": 7590463.292556926,
    "amount_eth": 1.1154601516168294,
    "amount_usd": 2072.3107919047116
  },
  {
    "block_number": 17780355,
    "timestamp": 1690411955,
    "transaction_hash": "0xa529900c2da259c35ba1b410ef73ccd26c59da4beaa39a30638a2d37e0543070",
    "token_address": "0x226f7b842e0f0120b7e194d05432b3fd14773a9d",
    "price_token_usd_tick_1": 0.0002899459618733211,
    "price_token_usd_tick_100": null,
    "price_token_usd_wavg_1h": null,
    "price_token_usd_wavg_24h": null,
    "volume_1h_usd": 37.4100258112716,
    "volume_24h_usd": 478.910210851682,
    "num_trades_1h": 1,
    "num_trades_24h": 4,
    "protocol_name": "uniswap_v2",
    "pool_address": "0x7f1da3697236d4a5e0efd2a99de5d9c076937856",
    "side": "buy",
    "amount_token": 129024.13115039762,
    "amount_eth": 0.02,
    "amount_usd": 37.41002581127157
  }
]

Example 3: All blocks between a time period

Request

https://api.syve.ai/v1/filter-api/blocks?gte:block_number=14000000&lte:block_number=14000100&size=5&sort=desc

Note: Here we use block_number to define the time period, but you could also use timestamp.

Response

[
  {
    "block_number": 14000100,
    "timestamp": 1642116323,
    "parent_hash": "0xceb9b6f9c1033082f88dd4b44ee7c6e489e243ad85cf279abc6081f0a1b265b6",
    "mix_hash": "0x281e48625c81dff4694b74e4eb5292a960fd7e1fb77ab2f9b503fd63e70081f7",
    "nonce": "0xa5a1a85d882c37e2",
    "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "difficulty": 12190828206303296,
    "total_difficulty": 38897356251947745000000,
    "size_bytes": 66856,
    "base_fee_per_gas_gwei": 182.152492238,
    "gas_limit": 30078167,
    "gas_used": 13123150,
    "transactions_count": 179,
    "miner_address": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
    "uncle_count": 0
  },
  {
    "block_number": 14000099,
    "timestamp": 1642116304,
    "parent_hash": "0x05c9ee34c78bf14347a62fd5eea72315c60886eae215d6e27dce80fab19b2b72",
    "mix_hash": "0x5fa5c9dd1de8853d2248ba6598ca8a3c7dcf8c8e191e63cc0bdfbbcb6567b6f5",
    "nonce": "0x006f7b61c59e2c55",
    "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "difficulty": 12196781518545500,
    "total_difficulty": 38897344061119534000000,
    "size_bytes": 82674,
    "base_fee_per_gas_gwei": 180.458274018,
    "gas_limit": 30107567,
    "gas_used": 16184433,
    "transactions_count": 243,
    "miner_address": "0x829bd824b016326a401d083b33d092293333a830",
    "uncle_count": 0
  },
  {
    "block_number": 14000098,
    "timestamp": 1642116296,
    "parent_hash": "0x6187a751ced21bb31062d49c51350ed8f3ec9dc26c49397cde859178e913fde8",
    "mix_hash": "0xaeca5416a2277907923de73b55d3a40f04d4b6650a427ef5bc04ad9d7dea6bef",
    "nonce": "0x9579751295b0798f",
    "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "difficulty": 12190826818904184,
    "total_difficulty": 38897331864338020000000,
    "size_bytes": 49922,
    "base_fee_per_gas_gwei": 190.877779901,
    "gas_limit": 30107567,
    "gas_used": 8479818,
    "transactions_count": 101,
    "miner_address": "0x829bd824b016326a401d083b33d092293333a830",
    "uncle_count": 0
  },
  {
    "block_number": 14000097,
    "timestamp": 1642116280,
    "parent_hash": "0x146330713b2e1b216be202d81e7a691feaf208acab667ec2f916ff2bc8b66a74",
    "mix_hash": "0xe86fab7f3ab264c6e65ccbfd31ab3934688a4e201ddc092d80fcb438c5525dd2",
    "nonce": "0x01ead1c82c42c8d1",
    "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "difficulty": 12190824671420536,
    "total_difficulty": 38897319673511200000000,
    "size_bytes": 51490,
    "base_fee_per_gas_gwei": 197.61221313,
    "gas_limit": 30107567,
    "gas_used": 10949636,
    "transactions_count": 141,
    "miner_address": "0x829bd824b016326a401d083b33d092293333a830",
    "uncle_count": 0
  },
  {
    "block_number": 14000096,
    "timestamp": 1642116256,
    "parent_hash": "0x7f4f82a043baea342bbe7148871cd02d39f54c33d7ac7c5d12778802a07f8047",
    "mix_hash": "0x5410de57383c2aa5ba2b35a6ae868ed168fa5626b1fd79e786b7e59cffaab7c1",
    "nonce": "0xf48a4ff3f66a12f9",
    "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "difficulty": 12196777981935880,
    "total_difficulty": 38897307482686530000000,
    "size_bytes": 86207,
    "base_fee_per_gas_gwei": 193.838586048,
    "gas_limit": 30107394,
    "gas_used": 17398206,
    "transactions_count": 275,
    "miner_address": "0x829bd824b016326a401d083b33d092293333a830",
    "uncle_count": 0
  }
]