Websocket API
You can access many of the events on our site through our websocket API, which allows you to listen for Listed, Sold, Cancelled, OfferMade, OfferUpdated and OfferAccepted events.
To connect, use a Socket.IO connection for the following URL: wss://api.ebisusbay.com. You can then setup the event listeners as shown above.
Using the websocket will allow you to cut-down on the amount of direct calls to the API for certain functionalities such as retrieving new listings, sales and more.
Event Examples
Listed
{
"nft": {
"nftId": "306",
"nftAddress": "0x3c46f9b9ffd5b3e63f5703bee0a27e59c7a6941e",
"burnt": false,
"edition": 306,
"name": "MiCrobots #306",
"original_image": "https://gateway.ebisusbay.com/ipfs/QmYdpjnGecbvDeHzG7tkPDLsrkbJCV8s6cQyNSFDTfAaLo/306.png",
"image": "https://cdn.ebisusbay.com/QmYdpjnGecbvDeHzG7tkPDLsrkbJCV8s6cQyNSFDTfAaLo/306.png",
"description": "When you're lonely, all you need is a Binky",
"rank": 134,
"attributes": [
{
"trait_type": "Location",
"value": "Junkyard",
"occurrence": 0.1424
},
{
"trait_type": "Base",
"value": "SkeleBaseOrange",
"occurrence": 0.0152
},
{
"trait_type": "Torso",
"value": "SkeleOrbPurple",
"occurrence": 0.0184
},
{
"trait_type": "TorsoAccessory",
"value": "BlueBowtie",
"occurrence": 0.0472
},
{
"trait_type": "FaceAccessory",
"value": "PinkTorch",
"occurrence": 0.0528
},
{
"trait_type": "Face",
"value": "MawlerYellow",
"occurrence": 0.0112
},
{
"trait_type": "Head",
"value": "SkeleHeadWhite",
"occurrence": 0.0224
},
{
"trait_type": "HeadAccessory",
"value": "MawlerCapYellow",
"occurrence": 0.0072
},
{
"trait_type": "Customs",
"value": "None",
"occurrence": 0.9856
},
{
"trait_type": "Trait Count",
"value": "8",
"occurrence": 0.5552
}
],
"market_uri": "https://app.ebisusbay.com/collection/0x3c46f9B9fFD5b3E63f5703BEE0A27e59c7A6941e/306"
},
"nftFromContract": true,
"listingId": 339507,
"nftId": "306",
"nftAddress": "0x3c46f9B9fFD5b3E63f5703BEE0A27e59c7A6941e",
"listingTime": 1661336636,
"saleTime": 0,
"endingTime": 0,
"state": 0,
"seller": "0x545114D6b4570B35162Bd3DF67E2ab2549F57A10",
"purchaser": "0x0000000000000000000000000000000000000000",
"fee": "4.5",
"price": "300.0",
"priceWei": "300000000000000000000",
"royalty": "30.0",
"is1155": false,
"time": 0
}
Sold
{
"nft": {
"nftId": "1737",
"nftAddress": "0xaed630f0b36dcbba21bdbe99f8662f13cc4fafb1",
"burnt": false,
"edition": 1737,
"name": "CRB #1737",
"original_image": "https://gateway.ebisusbay.com/ipfs/QmPHvUgkYnVQ5uCp3Stz28icvZ3u9F7kaVmAfpUSCsa7Ke/1737.png",
"image": "https://cdn.ebisusbay.com/QmPHvUgkYnVQ5uCp3Stz28icvZ3u9F7kaVmAfpUSCsa7Ke/1737.png",
"description": "The Crobees (CRB) is a randomly generated NFT collection based on the bee universe, each NFT are unique.",
"rank": 312,
"attributes": [
{
"trait_type": "Background",
"value": "Orange",
"occurrence": 0.0905
},
{
"trait_type": "Wings",
"value": "None",
"occurrence": 0.059
},
{
"trait_type": "Weapon",
"value": "None",
"occurrence": 0.9397
},
{
"trait_type": "Skin",
"value": "Classic",
"occurrence": 0.216
},
{
"trait_type": "Right Antenna",
"value": "No Piercing",
"occurrence": 0.7453
},
{
"trait_type": "Piercing",
"value": "None",
"occurrence": 0.7853
},
{
"trait_type": "Eyes",
"value": "Cyborg",
"occurrence": 0.0302
},
{
"trait_type": "Clothes",
"value": "None",
"occurrence": 0.1062
},
{
"trait_type": "Accessories",
"value": "Silver Chain",
"occurrence": 0.0378
},
{
"trait_type": "Mouth",
"value": "Smoke Ring",
"occurrence": 0.036
},
{
"trait_type": "Hat",
"value": "Cronos",
"occurrence": 0.0725
},
{
"trait_type": "Left Antenna",
"value": "No Piercing",
"occurrence": 0.734
},
{
"trait_type": "Special",
"value": "None",
"occurrence": 0.9658
},
{
"trait_type": "Trait Count",
"value": "6",
"occurrence": 0.11836183618361837
}
],
"market_uri": "https://app.ebisusbay.com/collection/0xAed630F0B36DcbBa21Bdbe99F8662f13CC4FaFB1/1737"
},
"nftFromContract": true,
"listingId": 339417,
"nftId": "1737",
"nftAddress": "0xAed630F0B36DcbBa21Bdbe99F8662f13CC4FaFB1",
"listingTime": 1661331075,
"saleTime": 1661337213,
"endingTime": 0,
"state": 1,
"seller": "0x67ccc07dbB3dBD9dC9b832aF63Ab084f64b2d00F",
"purchaser": "0x3e9A40e07De62F15e4ab2db205065528D0707C34",
"fee": "7.38",
"price": "246.0",
"priceWei": "246000000000000000000",
"royalty": "12.3",
"is1155": false,
"time": 0
}
Cancelled
{
"nft": {
"nftId": "5770",
"nftAddress": "0xf87a517a5caecaa03d7cca770789bdb61e09e05f",
"burnt": false,
"edition": 5770,
"name": "CroSkulls #5770",
"original_image": "https://gateway.ebisusbay.com/ipfs/QmZA9idEBomqsYBvA9ZH5JzuirmyQ414UBaqBGaEk2w69x/5770.png",
"image": "https://cdn.ebisusbay.com/QmZA9idEBomqsYBvA9ZH5JzuirmyQ414UBaqBGaEk2w69x/5770.png",
"description": "CroSkull is a collection of 6.666 uniquely generated NFTs stored on the Cronos Chain. Each CroSkull NFT is based on 6+ attributes with different rarities. A CroSkull is not simply a PFP but is also the key to the insane Dr. Jiko’s laboratory experiments.",
"score": 103.66429925896888,
"rank": 4683,
"attributes": [
{
"trait_type": "Background",
"value": "Blue",
"occurrence": 0.1241
},
{
"trait_type": "Body",
"value": "Back to school",
"occurrence": 0.0534
},
{
"trait_type": "Skull",
"value": "Bigsmileskull",
"occurrence": 0.0404
},
{
"trait_type": "Nose",
"value": "Splittrianglenose",
"occurrence": 0.1851
},
{
"trait_type": "Eyes",
"value": "Boredeyes",
"occurrence": 0.0659
},
{
"trait_type": "Hat",
"value": "Fishermanhat",
"occurrence": 0.0329
},
{
"trait_type": "Trait Count",
"value": "6",
"occurrence": 0.8634863486348635
}
],
"market_uri": "https://app.ebisusbay.com/collection/0xF87A517A5CaecaA03d7cCa770789BdB61e09e05F/5770"
},
"nftFromContract": true,
"listingId": 327725,
"nftId": "5770",
"nftAddress": "0xF87A517A5CaecaA03d7cCa770789BdB61e09e05F",
"listingTime": 1660644552,
"saleTime": 1661336783,
"endingTime": 0,
"state": 2,
"seller": "0xDc8024585AE18843C1715D67BB14B0361779efF7",
"purchaser": "0x0000000000000000000000000000000000000000",
"fee": "46.665",
"price": "3111.0",
"priceWei": "3111000000000000000000",
"royalty": "124.44",
"is1155": false,
"time": 0
}