Skip to content

API Call Guide: Part 2 (WoW API)

Jump to bottom
Alex Cohen edited this page Jul 3, 2024 · 17 revisions

WoW apis

swagger

View the full api and definitions on our swaggerhub page

converted with this tool

Also heres the TSM stats api docs for reference.

Heres the pricing apis which we dont directly use.

server to server trading

http://api.saddlebagexchange.com/api/wow/scan

 {
    "homeRealmId": 2074,
    "newRealmId": 1080,
    "min_historic_price": 10000,
    "desired_roi": 1,
    "sale_per_day": 0,

    "itemQuality": -1,
    "required_level": -1,
    "item_class": 15,
    "item_subclass": 5,
    "ilvl": -1
}

commodity shortage

http://api.saddlebagexchange.com/api/wow/commodity

{
    "desired_avg_price": 20,
    "desired_sales_per_day": 40,
    "desired_price_increase": 50,
    "desired_sell_price": 200,
    "flip_risk_limit": 100,
    "under_market_price_percent": 0,
    "over_market_price_percent": 0,

    "itemQuality": -1,
    "item_class": -1,
    "item_subclass": -1,
    "region": "EU"
}

single shortage

http://api.saddlebagexchange.com/api/wow/single

{
    "homeRealmId": 3678,
    "desired_avg_price": 20,
    "desired_sales_per_day": 2,
    "desired_price_increase": 100,
    "desired_sell_price": 40,
    "flip_risk_limit": 100,
    "under_market_price_percent": 0,
    "over_market_price_percent": 50,

    "itemQuality": 1,
    "required_level": -1,
    "item_class": -1,
    "item_subclass": -1,
    "ilvl": -1
}

itemnames

http://api.saddlebagexchange.com/api/wow/itemnames

By default this returns all dragonflight names

{}

You can also use it to call specific item ids:

{"item_ids":[25,200000]}

Or return all items current and legacy:

{"return_all": true}

server update times

http://api.saddlebagexchange.com/api/wow/uploadtimers

{}

wow undercut

http://api.saddlebagexchange.com/api/wow/undercut

{
    "homeRealmId": 3678,
    "region": "NA",
    "user_auctions": [
        {
            "itemID": 1,
            "price": 1
        },
        {
            "itemID": 52181,
            "price": 420
        },
        {
            "itemID": 4500, 
            "price": 97400
        },
        {
            "itemID": 173242,
            "price": 900000
        },
        {
            "itemID": 189145,
            "price": 22003000
        }
    ]
}

Marketshare Overview

http://api.saddlebagexchange.com/api/wow/itemstats

 {
    "homeRealmId": 3678,
    "region": "NA",
    "commodity": true,

    "desired_avg_price": 100.0,
    "desired_sales_per_day": 10000,

    "itemQuality": 1,
    "required_level": -1,
    "item_class": -1,
    "item_subclass": -1,
    "ilvl": -1
}

price checker

http://api.saddlebagexchange.com/api/wow/pricecheck

{
    "homeRealmName": "Thrall",
    "region": "US",
    "user_auctions": [
        {"itemID": 194683,"price": 39900,"desired_state": "below"},
        {"itemID": 194123,"price": 39900,"desired_state": "below"},
        {"itemID": 199972,"price": 250000000,"desired_state": "above"},
        {"itemID": 200014,"price": 300000000,"desired_state": "above"},
        {"itemID": 200014,"price": 197830470,"desired_state": "below"}
    ]
}

legacymarket

http://api.saddlebagexchange.com/api/wow/legacymarket

{
    "homeRealmId": 3678,
    "desired_avg_price": 1000000,
    "desired_sales_per_day": 1,
    "item_class": -1,
    "item_subclass": -1,
    "sort_by": "currentMarketValue"
}

listings

get the listings info on a single item

http://api.saddlebagexchange.com/api/wow/listings

 {
    "homeRealmId": 3678,
    "region": "NA",
    "itemID": 190320
}

pet marketshare

http://api.saddlebagexchange.com/api/wow/petmarketshare

{
    "region": "NA",
    "homeRealmName": "Thrall",
    "minPrice": 1000,
    "salesPerDay": 22,
    "sortBy": "minPrice"
}

pet server population

http://api.saddlebagexchange.com/api/wow/petservers

{
    "region": "NA",
    "petID": 3390,
    "populationWP": 3000,
    "populationBlizz": 1,
    "rankingWP": 90,
    "minPrice": 3000,
    "maxQuantity": 1000,
    "sortBy": "minPrice",
    "connectedRealmIDs": {
        "5": "Proudmoore",
        "9": "Kil'jaeden",
        "11": "Tichondrius",
        "3684": "Mal'Ganis",
        "3693": "Kel'Thuzad",
        "3723": "Barthilas",
        "3725": "Gundrak"
    }
}

region wide undercut check

http://api.saddlebagexchange.com/api/wow/regionundercut

{
    "region": "NA",
    "homeRealmID": 76,
    "addonData": [
        {
            "homeRealmName": "119",
            "region": "US",
            "user_auctions": [
                {"petID": 3524 ,"price": 9990000, "auctionID": 1220597524},
                {"petID": 845 ,"price": 22220000, "auctionID": 1220597957},
                {"petID": 844 ,"price": 19990000, "auctionID": 1223669108},
                {"petID": 3390 ,"price": 30000000, "auctionID": 1220597294}
            ]
        },{
            "homeRealmName": "1263",
            "region": "US",
            "user_auctions": [
                {"petID": 3331 ,"price": 99990000, "auctionID": 1223413494},
                {"petID": 3287 ,"price": 33301000, "auctionID": 1223413626},
                {"itemID": 194018, "price": 19990000, "auctionID": 1223413298},
                {"itemID": 194057, "price": 22220100, "auctionID": 1223389875},
                {"itemID": 194057, "price": 11110100, "auctionID": 1223389992},
                {"petID": 3390 ,"price": 13990000, "auctionID": 1223398262}
            ]
        }
    ]
}

pet shoppinglist

http://{{LOCAL}}/api/wow/petshoppinglist

{
    "region": "NA",
    "petID": 183,
    "maxPurchasePrice": 950000,
    "connectedRealmIDs": {
        "5": "Proudmoore",
        "9": "Kil'jaeden",
        "3676": "Area 52",
        "3678": "Thrall",
        "3683": "Dalaran",
        "3684": "Mal'Ganis",
        "3693": "Kel'Thuzad",
        "3723": "Barthilas",
        "3725": "Gundrak"
    }
}

pet import search

http://{{PROD}}/api/wow/petimport

{
    "ROI": 50,
    "avgPrice": 2000,
    "homeRealmID": 76,
    "maxPurchasePrice": 10000,
    "profitAmount": 2000,
    "region": "NA",
    "salesPerDay": 20,
    "sortBy": "lowestPrice",
    "includeCategories": [],
    "excludeCategories": [],
    "connectedRealmIDs": {
        "5": "Proudmoore",
        "9": "Kil'jaeden",
        "11": "Tichondrius",
        "3684": "Mal'Ganis",
        "3693": "Kel'Thuzad",
        "3723": "Barthilas",
        "3725": "Gundrak"
    }
}
Clone this wiki locally