Prepare a reprice draft
Plans a reprice into a draft you can review before anything is written. The call returns a runId at once with status preparing; poll GET /v1/inventory/reprice/runs/{runId} until it is ready. Planning always runs in the background.
The worker stores one absolute new price per card. Applying never recomputes a percentage, so a percent-of-current level is frozen at the price each card had when the draft was planned.
You have one draft at a time. Preparing a draft replaces every other draft that was never applied, including one you may be reviewing on cardnexus.com: using a replaced run returns 409 RUN_SUPERSEDED. A draft is valid for 24 hours after its last review change, and at most 72 hours after it was created.
Cards with no market price, cards already at the target price and cards the direction blocks are counted and left unchanged. While another reprice is preparing, applying or being undone, or an import or bulk edit runs, the call returns 409 INVENTORY_BUSY.
Requires the listings:write scope.
Body
- Properties: 2Type: objectlevelrequired
- Properties: 5Type: objectscoperequired
- Properties: 2Type: objectalso
List - Type: stringenumdirection
Which way prices may move, for every scope kind. A price rise removes the card from buyers' carts.
values- both
Prices may go down or up.
- down
Prices only go down.
- up
Prices only go up.
- both
- Type: objectfloorProperties: 2
Never price below this. The currency must be your seller currency. Default 0.25 in your market currency, converted and rounded up.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
curl https://public-api.cardnexus.com/v1/inventory/reprice/runs \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"scope": {
"kind": "group",
"group": "way-above"
},
"level": {
"kind": "sell-fast"
},
"direction": "both",
"floor": {
"amount": 1,
"currency": "USD"
},
"alsoList": {
"enabled": true,
"minMarketValue": 2
}
}'
{
"runId": "6717a4e2c1b0d9e8f7a6b5c4",
"status": "preparing"
}