Links

nft_topBuyerAndSeller

Get the top buyers and sellers of the whole NFT market without scanning the entire chain.
Through nft_topBuyerAndSeller, you can know who buy and sell most within certain time scale in the whole NFT market, type is necessary. No matter the volume or the count of transactions of specific top buyer/seller's wallet could be returned.
Supported on Ethereum and BNB Chain.

Parameters

Object - An object with the following fields (required):
  • type(hex string, required) - the specifies type of trade to query for. such as buy or sell.
  • timeDimension(string, optional) - time dimension, such as 1h 6h 12h 1d 3d 7d all.
  • pageSize(integer number, optional, default 20 max 50) - max number of results to return per call.
  • pageIndex(integer number, optional, default 1) - page index.

Returns

Object - An object with the following fields:
  • id(integer number) - JSON-RPC id.
  • jsonrpc(string) - JSON-RPC version.
  • result(object) - an object with the following fields:
    • nextPageIndex(integer number) - next page index.
    • data(array of object, defined below) - response data.
  • Object schema:
    • accountAddress(string) - account address.
    • volume(string) - total transaction volume(ETH or BNB).
    • count(integer number) - the count of transactions.

Example

Request

curl
TypeScript
curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"jsonrpc": "2.0",
"method": "nft_topBuyerAndSeller",
"params": {
"timeDimension": "3d",
"type": "buy",
"pageSize": 5,
"pageIndex": 1
}
}'
import { BlockVisionProvider, BvNetwork } from 'blockvision.js'
// Optional parameters, but default to eth-mainnet and default api-key.
const bv = new BlockVisionProvider(BvNetwork.ETH_MAINNET)
// Access the BlockVision NFT API
bv.getNFTTopBuyerAndSeller({
timeDimension: '3d',
type: 'buy'
}).then(console.log)

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"data": [
{
"accountAddress": "0x2d760eB3a94f639DaB372B27C73aaA29a8d44e39",
"volume": "3401",
"count": 3
},
{
"accountAddress": "0xb34d849c0551C6A4C0D491224BCc6114B906AfC4",
"volume": "300",
"count": 1
},
{
"accountAddress": "0x5FB65b6c6ab6D095381DbCfe2290d3D2814C4F3a",
"volume": "300",
"count": 1
},
{
"accountAddress": "0xca177D4b3E6d4C2778912B47e6aAe49b7c429819",
"volume": "250.5779",
"count": 3
},
{
"accountAddress": "0x4548D498460599286CE29BAf9e6B775C19385227",
"volume": "200",
"count": 1
}
]
}
}