Toadz API

https://toadzapi.herokuapp.com

Routes

Current Listings

/listings/:order/:limit

Returns an array of current Toadz listed.

/:order can either be "/asc" to order from cheapest to most expensive or vice versa with "/desc"

/:limit max 100

Returns

[
    {
        "_id": 5325,
        "rarityScore": 193.05,
        "rank": 2726,
        "last_updated": "2021-10-06T22:24:53.103Z",
        "collection_name": "Cryptoadz",
        "collection_contract_address": "0x1cb1a5e65610aeff2551a50f76a87a7d3fb649c6",
        "collection_slug": "cryptoadz-by-gremplin",
        "isListed": true,
        "seller_username": "z__",
        "link": "https://opensea.io/assets/0x1cb1a5e65610aeff2551a50f76a87a7d3fb649c6/5325",
        "seller_wallet": "0x1ff2875cd548eeae6d22f26bae2d72a50fd143c7",
        "image_url": "imageurl",
        "current_list_price": 12.4269,
        "previous_sale_price": 0.45,
        "previous_sale_date": "2021-09-09T04:04:53.000Z",
        "traits": [
            {
                "_id": "615cf0bef05ecd95c45f5660",
                "trait_type": "Body",
                "value": "Gummy Raspberry",
                "trait_count": 191,
                "trait_score": 36.78
            },
            ...
        ]
    }
    ...
]

Collection Stats

/stats

Returns data about collection

Returns

[
    {
        "_id": "6142847d575b3d54fc078cf4",
        "last_updated": "2021-10-06T22:54:42.068Z",
        "meta": {
            "name": "Cryptoadz",
            "contract_address": "0x1cb1a5e65610aeff2551a50f76a87a7d3fb649c6",
            "slug": "cryptoadz-by-gremplin",
            "logo_image_url": "imageurl",
            "banner_image_url": "bannerurl",
            "description": "CrypToadz are a collection 6969 small amphibious creatures ...."
        },
        "market_stats": {
            "one_day_volume": 2425.893299,
            "one_day_change": -0.45891215780055283,
            "one_day_sales": 109,
            "one_day_average_price": 22.25590182568807,
            "seven_day_volume": 18457.6398911197,
            "seven_day_change": 3.925020014062044,
            "seven_day_sales": 1546,
            "seven_day_average_price": 11.938965000724256,
            "thirty_day_volume": 34365.1669494651,
            "thirty_day_change": 0,
            "thirty_day_sales": 13077,
            "thirty_day_average_price": 2.6279090731410184,
            "total_volume": 34365.1669494651,
            "total_sales": 13080,
            "total_supply": 7025,
            "count": 7025,
            "num_owners": 3263,
            "average_price": 2.6273063417022247,
            "market_cap": 83871.2291300879,
            "floor_price": 12,
            "num_currently_listed": 1181
        },
        "recent_trade_stats": {
            "trade_count": 100,
            "average_gain": 14.321035760621605,
            "average_time_held": 16.19,
            "average_sale_price": 18.738830990000004,
            "num_in_profit": 97
        }
    }
]

Trades

/trades/:filter/:order/:limit

Returns an array of Toad trades

/:filter options are "/price", "/percent", or "/recent"

/:order can either be "/asc" or "/desc"

/:limit max 100

Returns

[
    {
        "_id": "5011",
        "collection_name": "Cryptoadz",
        "image_url": "imageurl",
        "permalink": "imageurl",
        "trader_wallet": "0x1511003b6b5add51b106285d35445c1420292b6d",
        "trader_username": "dvdrst",
        "first_sale_since_mint": false,
        "purchase_date": "2021-09-10T08:32:10.981225",
        "sell_date": "2021-10-06T22:49:26",
        "purchase_price_ETH": 2,
        "purchase_price_USD": 3596.12,
        "sell_price_ETH": 30,
        "sell_price_USD": 107883.59999999999,
        "profit_ETH": 28,
        "profit_percent_ETH": 1500,
        "days_held": 27
    }
]