Categories

Get the list of categories

This endpoint can be used to retrieve the list of all categories.

Request

GET /categories/list

Response

{ "success": true, "result": [ "english-adjectives", "double-emoji" // ... ] }

Get the domains of a category

This endpoint can be used to retrieve the list of domains of a category.

Request

GET /categories/list/{category}

Response

{ "success": true, "result": [ "qatar", "uganda" // ... ] }

Get categories statistics

This endpoint returns stats for all the categories.

Request

GET /categories/stats?start_time={start_time}&end_time={end_time}

Response

{ "success": true, "result": [ { "category_name": "0x999-club", "min_sale": 7.8846874, "max_sale": 80.0, "avg_price": 43.94234371185303, "volume": 87.88469, "owners": 1, "supply": 2 } // ... ] }

Get statistics for a category

This endpoint returns stats for a given category.

Request

GET /categories/stats/{category}?start_time={start_time}&end_time={end_time}

Response

{ "success": true, "result": [ { "min_sale": 7.8846874, "max_sale": 80.0, "avg_price": 43.94234371185303, "volume": 87.88469, "owners": 1, "supply": 2 } ] }

Get floors

This endpoint returns the current floors for all categories. Floor prices are given in USD value.

Request

GET /categories/floors

Response

{ "success": true, "result": { "0x999-club": 21.839999628067016, "4-letter-dictionary": 101.39999999999999 // ... } }

Get floor for a category

This endpoint returns the current floor for a given category. Floor prices are given in USD value.

Request

GET /categories/floors/{category}

Response

{ "success": true, "result": 21.839999628067016 }

Get supply

This endpoint can be used to retrieve the number of registered and unregistered domains of a category.

Request

GET /categories/supply

Response

{ "success": true, "result": { "0x999-club": { "total": 1000, "registered": 38, "unregistered": 962 } // ... } }

Get top categories by volume

This endpoint returns the top 10 categories by volume between start_time and end_time.

Request

GET /categories/top?start_time={start_time}&end_time={end_time}

Response

{ "success": true, "result": [ { "category_name": "10k-club", "volume": 177737.16 } ] }

Get owners

Request

This endpoint returns the public keys owning domains for a given category and the number of domains they own.

GET /categories/owners/{category}

Response

{ "success": true, "result": [ { "owner_key": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix", "nb_domains": 38 } ] }