S_stock
Gets the list of auctions you have created on Eneba (up to 10k auctions).
To iterate through more than 10k auctions, please use
S_stockBulkSearch
query
Supported arguments
The following arguments are supported by S_stock query:
Field | Type | Description |
---|---|---|
after | String | Returns the elements that come after the specified cursor. To get the items after 10000 hits use S_stockBulkSearch query |
first | Int | Returns up to the first n elements from the list |
stockId | S_Uuid | The ID of the stock. If NULL provided - all auctions will be returned |
productId | S_Uuid | The ID of the associated product. If NULL provided - all auctions will be returned |
filters | S_API_StockFilters | Stock filters and sorting. Do not include fields to ignore them |
Return type
The query returns theS_API_StockConnection
type.
Example usage
Query
Here we are asking detailed information about our auctions and their stock, including competition prices and commission rate Eneba will take.
query {
S_stock {
edges {
node {
id
product { id name }
unitsSold
onHold
onHand
declaredStock
status
expiresAt
createdAt
autoRenew
price { amount currency }
position
priceUpdateQuota { quota nextFreeIn totalFree }
commission {
rate {
amount
currency
}
label
}
competition(first: 10) {
edges {
node {
belongsToYou
merchantName
price {
amount
currency
}
}
}
}
}
}
}
}
Result
We can track how many keys are sold by unitsSold
field,
how many keys are added to cart by onHold
field, and how many keys are left to sell by onHand
field.
The position
field tells at what position your auction was listed last time the product page was opened.
The priceUpdateQuota
field shows useful information on how many free price updates are left or how long you might need to wait for free price updates.
This field will be useful together with the preventPaidPriceChange
input field for
S_update_auction
mutation.
{
"data": {
"S_stock": {
"edges": [
{
"node": {
"id": "94aec9d8-b955-11eb-8455-76503aaeb092",
"product": {
"id": "c17fd750-6aa8-11eb-bc0f-4e1b39722069",
"name": "Resident Evil Village / Resident Evil 8 Steam Key GLOBAL"
},
"unitsSold": 9,
"onHold": 3,
"onHand": 20,
"declaredStock": 5,
"status": "ACTIVE",
"expiresAt": "2022-11-19T07:01:02+00:00",
"createdAt": "2021-05-20T10:24:41+00:00",
"autoRenew": true,
"price": {
"amount": 11500,
"currency": "EUR"
},
"commission": {
"rate": {
"amount": 100,
"currency": "EUR"
},
"label": "Auctions commission"
},
"position": 18,
"priceUpdateQuota": {
"quota": 10,
"nextFreeIn": null,
"totalFree": 10
}
}
},
{
"node": {
"id": "62b9dd9c-f9aa-11eb-aead-2a8031bec809",
"product": {
"id": "b74c8bf2-6ab8-11ea-b2ae-ded0de511d8d",
"name": "DOOM Eternal - Deluxe Bethesda.net Key GLOBAL"
},
"unitsSold": 1,
"onHold": 0,
"onHand": 1,
"declaredStock": null,
"status": "INACTIVE",
"expiresAt": "2022-11-03T07:12:57+00:00",
"createdAt": "2021-08-10T07:12:57+00:00",
"autoRenew": true,
"price": {
"amount": 1084,
"currency": "EUR"
},
"commission": {
"rate": {
"amount": 10,
"currency": "EUR"
},
"label": "Auctions commission"
},
"position": null,
"priceUpdateQuota": {
"quota": 10,
"nextFreeIn": null,
"totalFree": 10
}
}
}
]
}
}
}