DocumentationAPI v1
Get a free key
Documentation/Markets/Favourites

Favourites

Favourite win rate and level-stakes return by price and format. Prices are history: held from 2016 to 20 March 2026, with no live prices since.

Livelast 30 days Archive and upwhole archive

Parameters

All optional, all in the query string
fromdate
Earliest date to include, YYYY-MM-DD.
todate
Latest date to include, YYYY-MM-DD.
tierenum
Only this tier: majors, players_championship, european_tour, world_series, qualifiers, development_tour, challenge_tour, womens_series, junior, regional, wdf_platinum, wdf_gold, wdf_silver, wdf_bronze, and so on.

Try it

Your key, sent from your browser straight to the API
Paste your keyGet a free one in a minute
GET
https://api.dartsapi.com/v1/markets/favourites

          

            
Run it to see your limits

            
                      

        

        

      


      

        

          
What comes back
In data, read from a real response

                    

            
FieldTypeExample

            
                          
by_pricelist3 items

                          
by_formatlist3 items

                          
allobject{ favourites, outsiders }

                                    
          

                  

        

          
When it refuses
Every error code

          

            
StatusCodeWhen

            
              
401no_keyNo key, a malformed key, or one that is not ours.

              
402upgrade_requiredYour plan does not reach this endpoint. The message names the plan that does.
                            
422bad_parameterA parameter is malformed or out of range, named in the message.
              
429rate_limitedOver your rate or allowance. Retry-After says when.

            
          

        

      


            

        
Related

        
Prices in bulkPaidGET /v1/prices/bulkPriced history in bulk for model builders. Prices are history: held from 2016 to 20 March 2026, with no live prices since.CalibrationPaidGET /v1/markets/calibrationImplied probability against what actually happened, by price band. Prices are history: held from 2016 to 20 March 2026, with no live prices since.UpsetsPaidGET /v1/markets/upsetsThe longest-priced winners and upset rates. Prices are history: held from 2016 to 20 March 2026, with no live prices since.