Waiver Order v2.0
Summary
| Waiver Order | |
| Resource | |
| Waiver Order | A list of teams and their waiver rank, in waiver order. |
| HTTP Methods | |
| GET | Retrieve the waiver order for a league |
| Example | |
| Search For Players | Order for Leagues that use Waivers for Add/Drops |
| XML field definitions | |
| /waiver_order | A container element for the waiver order. |
| /waiver_order/ | A container element for the list of teams in the waiver order. |
| /waiver_order/ | A container element for data on a fantasy team in the waiver order. |
| /waiver_order/ | The ID of the fantasy team. |
| /waiver_order/ | An abbreviation of the team’s name, as a string with a maximum length of 3 characters. |
| /waiver_order/ | The URL of the team’s logo. |
| /waiver_order/ | An abbreviation of the team’s name, as a string with a maximum length of 10 characters. |
| /waiver_order/ | The full name for the team. |
| /waiver_order/ | The team’s position in the waiver order, as an integer. |
| /waiver_order/ | An abbreviation of the team’s name, as a string with a maximum length of 6 characters. |
| /faab_order | A container element for the faab order. |
| /faab_order/ | A container element for the list of teams in faab order. |
| /faab_order/ | A container element for data on a fantasy team in the faab order. |
| /faab_order/ | The ID of the fantasy team. |
| /faab_order/ | An abbreviation of the team’s name, as a string with a maximum length of 3 characters. |
| /faab_order/ | The remaining budget for a fantasy team in dollars. |
| /faab_order/ | The URL of the team’s logo. |
| /faab_order/ | An abbreviation of the team’s name, as a string with a maximum length of 10 characters. |
| /faab_order/ | The full name for the team. |
| /faab_order/ | The team’s position in the waiver order, as an integer. |
| /faab_order/ | An abbreviation of the team’s name, as a string with a maximum length of 6 characters. |
Waiver Order
Description
A list of teams and their waiver rank, in waiver order.
To provide an equal opportunity for all owners to add players to their roster, a waivers process is implemented. Requests for players who are on waivers are not executed immediately, but are put in a pending status. This allows multiple teams to request the same players. Each night between midnight and 9AM ET, CBSSports.com will process all of the pending requests. The order in which these requests are processed is based on the waiver order. Waiver order is a list of teams and their waiver rank. When the automated waiver process runs, the first pending transaction that gets processed is the the transaction with the hightest priority for the team that has the waiver rank of 1 (or is at the top of the waiver order). As teams make successful transactions, they get moved to the bottom of the order and other teams move up a spot in the order.
The initial waiver order for the first waiver run of the fantasy league’s season is reverse of the draft order. Based on the fantasy league’s waiver reset policy, the waiver order either resets every week based on the reverse of the standings or doesn’t reset at all.
If the fantasy league uses waivers as their add/drop policy, any player that is dropped from a fantasy team’s roster goes on waivers and stays on waivers a minimum number of days determined by the waiver period in the league’s rules. Even after that period has passed, the player stays on waivers until the next waiver cycle after he is eligible to come off waivers. Some leagues also have a policy where all free agents (players that aren’t on fantasy rosters) are on waivers.
If the fantasy league uses Free Agent Auction Bidding as their add/drop policy, all players are on waivers at all times. Fantasy team owners have a budget for add/drops to start the season and place bids for players they would like. The player is then awarded to the highest bidder with ties in bid amounts going to the team that is higher up in the waiver order. The player with the highest bid is auctioned off first, followed by the player with the second highest bid and so on till there are no more players to be auctioned off. Once a team is awarded a player, the winning bid amount is deducted from their remaining budget and the team is moved to the bottom of the faab order.
GET
Retrieve the waiver order for a league
URL
http://api.cbssports.com
Parameters
| response_format | (optional) Specifies the format in which the requested resource should be returned. Valid values are XML and JSON. The default is XML. |
Search For Players
Sample URL
Order for Leagues that use Waivers for Add/Drops
http://api.cbssports.com/fantasy/league/transactions/waiver-order?version=2.0
XML Response
<?xml version="1.0"?>
<result uriAlias="/league/transactions/waiver-order" uri="/league/transactions/waiver-order" statusCode="200" statusMessage="OK">
<body>
<waiver_order>
<teams>
<team id="4">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team4</long_abbr>
<abbr>T4</abbr>
<short_name>Team 4</short_name>
<order>1</order>
<name>Team 4</name>
</team>
<team id="6">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team6</long_abbr>
<abbr>T6</abbr>
<short_name>Team 6</short_name>
<order>2</order>
<name>Team 6</name>
</team>
<team id="1">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team1</long_abbr>
<abbr>T1</abbr>
<short_name>Team 1</short_name>
<order>3</order>
<name>Team 1</name>
</team>
<team id="7">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team7</long_abbr>
<abbr>T7</abbr>
<short_name>Team 7</short_name>
<order>4</order>
<name>Team 7</name>
</team>
<team id="5">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team5</long_abbr>
<abbr>T5</abbr>
<short_name>Team 5</short_name>
<order>5</order>
<name>Team 5</name>
</team>
<team id="2">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team2</long_abbr>
<abbr>T2</abbr>
<short_name>Team 2</short_name>
<order>6</order>
<name>Team 2</name>
</team>
<team id="3">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team3</long_abbr>
<abbr>T3</abbr>
<short_name>Team 3</short_name>
<order>7</order>
<name>Team 3</name>
</team>
<team id="9">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team9</long_abbr>
<abbr>T9</abbr>
<short_name>Team 9</short_name>
<order>8</order>
<name>Team 9</name>
</team>
<team id="8">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team8</long_abbr>
<abbr>T8</abbr>
<short_name>Team 8</short_name>
<order>9</order>
<name>Team 8</name>
</team>
<team id="10">
<logo>http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif</logo>
<long_abbr>Team10</long_abbr>
<abbr>T1</abbr>
<short_name>Team 1</short_name>
<order>10</order>
<name>Team 10</name>
</team>
</teams>
</waiver_order>
</body>
</result>JSON Response
{
"body" : {
"waiver_order" : {
"teams" : [
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team4",
"abbr" : "T4",
"short_name" : "Team 4",
"order" : 1,
"name" : "Team 4",
"id" : "4"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team6",
"abbr" : "T6",
"short_name" : "Team 6",
"order" : 2,
"name" : "Team 6",
"id" : "6"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team1",
"abbr" : "T1",
"short_name" : "Team 1",
"order" : 3,
"name" : "Team 1",
"id" : "1"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team7",
"abbr" : "T7",
"short_name" : "Team 7",
"order" : 4,
"name" : "Team 7",
"id" : "7"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team5",
"abbr" : "T5",
"short_name" : "Team 5",
"order" : 5,
"name" : "Team 5",
"id" : "5"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team2",
"abbr" : "T2",
"short_name" : "Team 2",
"order" : 6,
"name" : "Team 2",
"id" : "2"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team3",
"abbr" : "T3",
"short_name" : "Team 3",
"order" : 7,
"name" : "Team 3",
"id" : "3"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team9",
"abbr" : "T9",
"short_name" : "Team 9",
"order" : 8,
"name" : "Team 9",
"id" : "9"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team8",
"abbr" : "T8",
"short_name" : "Team 8",
"order" : 9,
"name" : "Team 8",
"id" : "8"
},
{
"logo" : "http://sports.cbsimg.net/images/splash/football/lg-mgmtgold.gif",
"long_abbr" : "Team10",
"abbr" : "T1",
"short_name" : "Team 1",
"order" : 10,
"name" : "Team 10",
"id" : "10"
}
]
}
},
"uriAlias" : "/league/transactions/waiver-order",
"statusMessage" : "OK",
"uri" : "/league/transactions/waiver-order",
"statusCode" : 200
}Order for Leagues that use FAAB (Free Agent Auction Bidding) for Add/Drops
http://api.cbssports.com/fantasy/league/transactions/waiver-order?version=2.0
XML Response
<?xml version="1.0"?>
<result uriAlias="/league/transactions/waiver-order" uri="/league/transactions/waiver-order" statusCode="200" statusMessage="OK">
<body>
<faab_order>
<teams>
<team id="8">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team8</long_abbr>
<abbr>T8</abbr>
<short_name>Team 8</short_name>
<order>1</order>
<name>Team 8</name>
</team>
<team id="5">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team5</long_abbr>
<abbr>T5</abbr>
<short_name>Team 5</short_name>
<order>2</order>
<name>Team 5</name>
</team>
<team id="4">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team4</long_abbr>
<abbr>T4</abbr>
<short_name>Team 4</short_name>
<order>3</order>
<name>Team 4</name>
</team>
<team id="2">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team2</long_abbr>
<abbr>T2</abbr>
<short_name>Team 2</short_name>
<order>4</order>
<name>Team 2</name>
</team>
<team id="1">
<budget_remaining>$99</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team1</long_abbr>
<abbr>T1</abbr>
<short_name>Team 1</short_name>
<order>5</order>
<name>Team 1</name>
</team>
<team id="9">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team9</long_abbr>
<abbr>T9</abbr>
<short_name>Team 9</short_name>
<order>6</order>
<name>Team 9</name>
</team>
<team id="10">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team10</long_abbr>
<abbr>T1</abbr>
<short_name>Team 1</short_name>
<order>7</order>
<name>Team 10</name>
</team>
<team id="7">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team7</long_abbr>
<abbr>T7</abbr>
<short_name>Team 7</short_name>
<order>8</order>
<name>Team 7</name>
</team>
<team id="6">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team6</long_abbr>
<abbr>T6</abbr>
<short_name>Team 6</short_name>
<order>9</order>
<name>Team 6</name>
</team>
<team id="3">
<budget_remaining>$100</budget_remaining>
<logo>http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif</logo>
<long_abbr>Team3</long_abbr>
<abbr>T3</abbr>
<short_name>Team 3</short_name>
<order>10</order>
<name>Team 3</name>
</team>
</teams>
</faab_order>
</body>
</result>JSON Response
{
"body" : {
"faab_order" : {
"teams" : [
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team8",
"abbr" : "T8",
"short_name" : "Team 8",
"order" : 1,
"name" : "Team 8",
"id" : "8"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team5",
"abbr" : "T5",
"short_name" : "Team 5",
"order" : 2,
"name" : "Team 5",
"id" : "5"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team4",
"abbr" : "T4",
"short_name" : "Team 4",
"order" : 3,
"name" : "Team 4",
"id" : "4"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team2",
"abbr" : "T2",
"short_name" : "Team 2",
"order" : 4,
"name" : "Team 2",
"id" : "2"
},
{
"budget_remaining" : "$99",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team1",
"abbr" : "T1",
"short_name" : "Team 1",
"order" : 5,
"name" : "Team 1",
"id" : "1"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team9",
"abbr" : "T9",
"short_name" : "Team 9",
"order" : 6,
"name" : "Team 9",
"id" : "9"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team10",
"abbr" : "T1",
"short_name" : "Team 1",
"order" : 7,
"name" : "Team 10",
"id" : "10"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team7",
"abbr" : "T7",
"short_name" : "Team 7",
"order" : 8,
"name" : "Team 7",
"id" : "7"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team6",
"abbr" : "T6",
"short_name" : "Team 6",
"order" : 9,
"name" : "Team 6",
"id" : "6"
},
{
"budget_remaining" : "$100",
"logo" : "http://sports.cbsimg.net/images/splash/baseball/lg-mgmtgold.gif",
"long_abbr" : "Team3",
"abbr" : "T3",
"short_name" : "Team 3",
"order" : 10,
"name" : "Team 3",
"id" : "3"
}
]
}
},
"uriAlias" : "/league/transactions/waiver-order",
"statusMessage" : "OK",
"uri" : "/league/transactions/waiver-order",
"statusCode" : 200
}/waiver_order/teams/team/@id
The ID of the fantasy team. You can get a list of fantasy team IDs by requesting the Fantasy Teams resource.
/faab_order/teams/team/@id
The ID of the fantasy team. You can get a list of fantasy team IDs by requesting the Fantasy Teams resource.
