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 } ]