HydraStats API is is an open HTTP-based interface that allows fair use access to the HydraStats database. 7 endpoints provide current and historical drug prices, supply and demand indicators.
/api/price/ — average price for selected subcategories of products (breakdown by date and location)
/api/price/dist/ — price distribution for selected subcategories (breakdown by price bins)
/api/supply/ — number of offers, positions or stores for selected categories of products (breakdown by date and location)
/api/supply/quantity/ — number of instant offers for selected subcategories (breakdown by amount)
/api/supply/category/ — breakdown of offers, positions or stores by category
/api/reviews/ — number of reviews in selected category (breakdown by date and location)
/api/reviews/get/ — get random review
All prices are in USD.
/api/price/?subcategory=marijuana gives the median price for a gram of cannabis buds in Belarus counting offers of 0-10 grams for the last 30 days.
/api/price/?subcategory=ecstasy&start=2019-05-01&end=2020-05-01&quantity_start=5&quantity_end=10&integral=1&city=Minsk gives median price of an ecstasy pill in Minsk over a year, counting offers from 5 to 10 pills.
/api/price/?subcategory=mephedrone&start=2019-05-01&end=2020-05-01&city=breakdown&integral=1 gives city breakdown of the median price of mephedrone over a year.
Gives price distribution for a subcategory. Response contains a list with the number of appearances "hist", and a list of bin edges "bins".
/api/price/dist/?subcategory=marijuana&city=Minsk gives the distribution of marijuana price in Minsk for the last 30 days
/api/price/dist/?subcategory=cocaine&start=2019-05-01&end=2020-05-01&integral=1 gives cocaine price distribution data for a year
Gives the number of instant offers, positions or stores (see argument unique)".
/api/supply/ gives current number of unique instant offers
/api/supply/?category=psychedelic&Minsk&unique=2 gives the number of unique psychedelic products that were available in Minsk in the last 30 days
/api/supply/?category=alphapvp&unique=3&start=2020-01-01&end=2020-12-31&integral=1 gives the number of stores that were selling α-PVP in 2020
Gives the number of instant offers, positions or stores with a breakdown by category.
/api/supply/category/ gives current distribution of unique offers by category
/api/supply/category/?date=2020-01-01 gives no data as there is no snapshot of 2020-01-01
Gives a breakdown of instant offers in a subcategory by quantity.
/api/supply/quantity/?subcategory=marijuana gives a current breakdown of unique marijuana offers by quantity
Gives the number of customer reviews with a breakdown by locality and date
/api/reviews/?start=2020-01-01&end=2020-01-31&integral=1 gives the number of reviews for January 2020
/api/reviews/?start=2020-01-01&end=2020-01-31&category=cannabis&city=Minsk gives a breakdown of the number of reviews on cannabis products in Minsk
Gives the text of a random review.
/api/reviews/get/ gives a random review from the database
/api/reviews/get/?rating_end=1&category=alphapvp gives a random unsatisfactory review about α-PVP