Marketplace Activity API
Marketplace Activity API
Date Update
The Marketplace Activity API is a collection of endpoints which will be exposed to the public
for the consumption by individuals or 3rd party stats providers. This document is intended
as a technical overview of the various endpoints available along with a description of
parameters and outputs.
In accordance with the DraftKings Terms of Use, you may not use any API (including
without limitation, to any public API) or any DraftKings issued end point to create, use,
operate, or employ any bots, robots, parser, spiders, scripts, programs, routines, or any
other forms of automation for any component of a transaction on the DraftKings
Marketplace or the Website. In addition, you may also not use any web scraping, web
harvesting, or data extraction methods to extract any data from the Website or the
DraftKings Marketplace.
Base Url
https://marketplace.draftkings.com/api/activity/{Version}
Version Notes
Key Terms
Term Description
Pack An entity that represents the shared details for a particular set
of Pack Editions.
Pack Edition A specific edition of a Pack which has been minted as an NFT,
Pack Editions produce a predefined amount of Collectible
Editions when opened. Despite the fact that they exist
on-chain, Pack Editions can only be opened on DK
Marketplace. Pack Editions are also interchangeable until
opened so they do not have Edition Numbers. Instead they are
identified by a PackEditionKey
Merchandise Either:
● Collectible
● Pack
Type Definitions
Some endpoints below have certain types that are either taken in or returned as strings.
MerchandiseType
Name Description
TransactionType
Name Description
PrimaryPurchaseConfirmation
● Provides price, time, and user information
about Collectible/Pack Editions purchased
from Drops
● Includes Merchandise metadata
SecondaryPurchaseConfirmati
on ● Provides price, time, and user information
about Collectible/Pack Editions purchased
from the secondary market
● Includes Merchandise metadata
SellPlacement
● Provides price, time, and user information
about Collectible/Pack Editions listed on the
secondary market regardless of whether it
actually sold
● Includes Merchandise metadata
PackOpened
● Provides user information and time
information about when a Pack Edition was
opened
● Includes Merchandise metadata
PackAward
● Provides user information and time
information about a Collectible Edition that
was revealed from a Pack Edition
● Includes Merchandise metadata
● Includes basic parent Merchandise metadata
○ Excludes Thumbnail
AdminReward
● Provides user information about
Collectible/Pack Editions airdropped or
otherwise gifted inside the Marketplace
● Includes Merchandise metadata
AwardFromSupplier
● Provides user information about
Collectible/Pack Editions won in an internal DK
contest
● Includes Merchandise metadata
AwardFromAuction
● Provides price, time, and user information
about Collectible/Pack Editions won through
an auction
● Includes Merchandise metadata
TransferComplete
● Provides blockchain wallet, transaction, time,
and user information about Collectible/Pack
Editions withdrawn from marketplace to an
external wallet
● Includes Merchandise metadata
DepositComplete
● Provides blockchain wallet, transaction, time,
and user information about Collectible/Pack
Editions deposited to a marketplace portfolio
from an external wallet
● Includes Merchandise metadata
Minted
● Includes time and Merchandise metadata from
when any Edition was minted by marketplace
AwardFromCrafting
● Provides information about Collectible/Pack
Editions awarded from a crafting recipe
● Includes Merchandise metadata
Burned
● Provides information about Collectible/Pack
Editions burned on the blockchain and no
longer available in marketplace
● Includes Merchandise metadata
EventType
Event types represent aggregations (or in some cases one-to-one mapping) of
TransactionType. These are the types that are used as filter parameters instead of
TransactionType, but transaction type names are included in responses on individual
transactions
Sales
The event type accounts for
● PrimaryPurchaseConfirmation
● SecondaryPurchaseConfirmation
Listings SellPlacement
Prize AwardFromSupplier
Open PackOpened
Reward AdminReward
Won AwardFromAuction
Withdraw TransferComplete
Deposit DepositComplete
Received PackAward
Mint Minted
CraftingAward AwardFromCrafting
Burn Burned
Endpoints
The Activity API contains the following endpoints
Route
Request Parameters
Limit Int Page size - currently 200 is the maximum page size
we support for this query. If no limit is provided, the
default is also 200
String This value is for paging and should be obtained off
Cursor of the response from this query and sent back to get
the next page
● Received
● Mint
Response
Body
This is the main body of the response
MerchandiseTransactionRecord
These properties are grouped here for clarity, but they all exist at the root of this object.
Each transaction record identifies metadata and transaction specific information related to
a particular Collectible Edition (NFT) or Pack Edition in the Marketplace.
● "Image"
● "Video"
● "image/png"
● "video/mp4"
● "application/x-mpegURL"
● TransferComplete
● DepositComplete
● TransferComplete
● DepositComplete
Attribute
● "Number"
● "Text"
● "Boolean"
Name: "Position”
Value: "Quarterback"
ErrorStatus
Error Codes
These codes can be returned from the Activity API
Example
Description Retrieve the most recent Sales transaction from all Collectibles
in the Reignmakers Football Collection
Response
"transactions": [
{
"thumbnailUrl":
"https://marketplace.draftkings.com/_assets/Staging/2022-08-14_Prize_Master/Thumbnails/s
et_prizev12022_tyler_lockett_19905_core_thumbnail.png",
"thumbnailType": "Image",
"thumbnailMediaType": "image/png",
"merchandiseName": "Tyler Lockett: 2022 Prize Set (CORE)",
"merchandiseKey": "d8f60d4260164d5f9b7136f0b3a7fb18",
"merchandiseType": "Collectible",
"editionNumber": 179,
"totalQuantity": 600,
"collectionKey": "5eae2563006d4fe0ae1405a31567c60c",
"collectionName": "Reignmakers Football Collection",
"supplierKey": "a36385bff3e011ec85f81223fa216287",
"supplierName": "DraftKings x NFLPA",
"attributes": [
{
"name": "Athlete Name",
"valueType": "Text",
"value": "Tyler Lockett",
"valueUrl": ""
},
{
"name": "Edition Tier",
"valueType": "Text",
"value": "Skill Starters"
},
{
"name": "PlayerDkId",
"valueType": "Number",
"value": "19905",
"valueUrl": ""
},
{
"name": "Position",
"valueType": "Text",
"value": "WR"
},
{
"name": "Rarity Tier",
"valueType": "Text",
"value": "Core"
},
{
"name": "Rookie Status",
"valueType": "Text",
"value": "No"
},
{
"name": "Series",
"valueType": "Text",
"value": "2022"
},
{
"name": "Set Name",
"valueType": "Text",
"value": "Prize"
},
{
"name": "SuperStar Status",
"valueType": "Text",
"value": "No"
},
{
"name": "Team",
"valueType": "Text",
"value": "SEA"
},
{
"name": "GameCard",
"valueType": "Text",
"value":
"https://api.draftkings.com/nftgames/assets/reignmakers-football/collectiblegamecards/set_p
rizev12022_tyler_lockett_19905_core_gamecard.png",
"valueUrl": ""
}
],
"transactionKey": "q/oVIAO7w0WMLq68M4su2j/AUKXsstaFzlvbcOFKjh4=",
"transactionType": "SecondaryPurchaseConfirmation",
"transactionDate": "2022-11-08T20:24:49.0000000+00:00",
"username": "Superunknown454",
"userKey": "8d4e26ad-1a1f-4653-bd03-6d06104e3e63",
"amount": 6.0,
"currencyCode": "USD",
"relatedTransactionCount": 0
}
],
"cursor": "1667939089000|bqapPq"
}
Cursor Use
The Transaction query is paged and defaults to 200 records (this is also currently the max
allowed). This means that the response from the Transactions endpoint will contain a string
Cursor property if there are more records that match the specified filters. This Cursor
property can be passed into a subsequent call to the query which, if combined with the
same filter parameters, will result in the next page being returned with no duplicate data.
From the example above, to get the next page you would simply add the Cursor property
from the response as a parameter to the API call:
Maximum Transactions We do not allow requests for more than 200 transactions at a
per request time
Route
(relatedTransactionCount
--header 'Content-Type:
> 0). application/json' \
--data-raw '{
"TransactionKey": "XYZ"
}'
Request Parameters
TransactionKey String Provide the key for a Transaction you want to get
related Transactions for. This is a unique identifier
for this transaction in the Marketplace.
Response
Body
This is the main body of the response
MerchandiseTransactionRecord
ErrorStatus
Error Codes
Example
Description Retrieve the Collectibles received from a Pack that was opened.
Prerequisite use the Activity API to get the TransactionKey from an
Open transaction
Response
"transactions": [
"thumbnailUrl":
"https://marketplace.draftkings.com/_assets/collectibles/assets/922bdf4c-7aac-42fd-868
a-9e43610b3a64.png",
"thumbnailType": "Image",
"thumbnailMediaType": "image/png",
"merchandiseKey": "289dc5a8b60745d9a3daad80786034a0",
"merchandiseType": "Collectible",
"editionNumber": 592,
"totalQuantity": 720,
"collectionKey": "8b8f14fb451944aca580a1e6bcb95cd4",
"supplierKey": "a363864af3e011ec85f81223fa216287",
"attributes": [
"name": "Series",
"valueType": "Text",
"value": "2023"
},
"valueType": "Text",
"value": "Genesis"
},
"valueType": "Text",
"value": "Core"
},
"valueType": "Text",
"valueUrl": ""
},
"name": "PlayerDkId",
"valueType": "Number",
"value": "202992",
"valueUrl": ""
},
"name": "GameCard",
"valueType": "Text",
"value":
"https://api.draftkings.com/nftgames/assets/reignmakers-ufc/collectiblegamecards/set_
ufcgenesis_damir_ismagulov_202992_core_gamecard.png",
"valueUrl": ""
},
"name": "Country",
"valueType": "Text",
"value": "Kazakhstan"
},
"name": "Division",
"valueType": "Text",
},
"valueType": "Text",
"value": "No"
},
"valueType": "Text",
"value": "Ranked"
],
"parentMerchandiseKey": "680f504484114c93bbc943607f032013",
"parentMerchandiseEditionKey": "6ad475b8c95b485f80a0f8f4ab09bf9b",
"transactionKey": "Dj4rOrkocXQ%2fODur2iBBZuz4lFIeWEvjF6gSDClOBpY%3d",
"transactionType": "PackAward",
"transactionDate": "2023-03-01T17:34:14.0000000+00:00",
"username": "...",
"userKey": "...",
"currencyCode": "USD",
"relatedTransactionCount": 0
},
…
]
SLA Expected
Rate No more than 30 requests per 30 seconds (1 request per
second)
Collections
Reignmakers
Others
Collection Name Collection Key
SlyCrocs 46E32B366C5743FB98B34914B5DCA83F
Autograph A3638152F3E011EC85F81223FA216287
DraftKings A3638494F3E011EC85F81223FA216287
Metabilia A3638534F3E011EC85F81223FA216287
SupDucks 1F3E0426A416498C91DA5A5741CF90DA
Deadfellaz ABA74636D5F540C8B8F2BB6D133EA61A
DraftKings Inc.
222 Berkeley Street, 5th Floor, Boston, MA, 02116