Errors
The status says what happened. A 4xx means the request can't be done as sent, and a 5xx that it is worth trying again.
200, 201 | It worked. The body is the result. |
|---|---|
204 | It worked, and there is nothing to answer. |
400 | The body isn't valid JSON, a filter is wrong, or a required header is missing. |
401 | The key is missing or unknown. |
402 | The balance doesn't cover the purchase. |
403 | This account can't do this. |
404 | There is no such thing, or no copy of your inventory yet. |
409 | Something changed: the lot sold, the price is new, the deal moved on. Read it again. |
413 | The upload is over the limit. |
422 | A value in the request can't be used. |
429 | Too many requests. Wait for Retry-After. |
502 | A service behind the API is away. Try again in a moment. |
Refusals
When there is a reason you can act on, the body names it in code. These codes don't change, so your program can rely on them. Other failures are the status with a line of text, which is for people.
{ "code": "not_enough_money" }| Status | Code | When |
|---|---|---|
| 400 | bad_address | The address is not one of Tron's. |
| 400 | bad_image | A message takes up to 3 screenshots, PNG or JPEG, of up to 8 MB each. |
| 400 | bad_ticket | A ticket needs a topic and a message of up to 2000 characters. |
| 400 | too_little | Less than $1.00 goes out. |
| 400 | unknown_coin | Rockvel does not send this coin in this network. |
| 402 | not_enough_money | The balance doesn't cover the price. |
| 403 | banned | This account can't start anything new on Rockvel. |
| 403 | not_your_order | This deal isn't yours, or this step belongs to the other side. |
| 403 | stall_suspended | Rockvel has suspended your stall, and only Rockvel can lift it. |
| 404 | no_such_auto_buy | There is no such auto-buy waiting: it bought all it asked for, was called off, or isn't yours. |
| 404 | no_such_bargain | There is no such bargain waiting for your answer: it ended, it is the other side's turn, or it isn't yours. |
| 404 | no_such_order | There is no such deal. |
| 404 | no_such_ticket | No such ticket of yours. |
| 404 | no_such_withdrawal | No such withdrawal of yours. |
| 409 | already_listed | One of the items is already on sale or sold. |
| 409 | already_signed | The withdrawal is signed already and goes ahead. |
| 409 | buyer_cannot_pay | The buyer no longer has the money for this price, so the bargain ended. |
| 409 | item_gone | An item isn't in your inventory copy. Upload a fresh one and try again. |
| 409 | item_unknown | An item isn't in the catalog yet. |
| 409 | lot_gone | The lot sold or was taken down. |
| 409 | no_trade_url | Set your trade link first. |
| 409 | none_match | No lot matches the price and filters now. |
| 409 | not_refundable | Your deposits cannot give back this much, or a source would get less than the minimum. |
| 409 | order_moved_on | The deal moved on and this step no longer applies. Read it again. |
| 409 | own_lot | This is your own lot. |
| 409 | price_changed | The seller changed the price. Read the lot and try again. |
| 409 | ticket_closed | The ticket is closed: open a new one. |
| 409 | too_early | The seller still has time: wait for buyer_cancels_at. |
| 409 | too_many_auto_buys | You already have 100 auto-buys waiting. Call one off first. |
| 409 | too_many_bargains | You already have 100 prices waiting for an answer. Take one back first. |
| 409 | too_many_tickets | You have as many open tickets as you can. |
| 409 | wait_for_answer | Wait for support to answer before you write more. |
| 422 | bad_bargain | The lot takes no bargains, the price isn't below the lot's and within its max_discount, or a counter isn't between the buyer's price and the lot's. |
| 422 | bad_description | The description is longer than 32 characters, has more than one line or space at its ends. |
| 422 | bad_discount | The discount is outside 0 to 50 percent. |
| 422 | bad_lot | The list is empty, a price is outside 3 to 100000000 cents, or a filter is outside its range. |
| 422 | bad_trade_url | This isn't the trade link of this Steam account. |
| 422 | one_buyer_per_offer | The deals of one offer must all go to one buyer. |
| 422 | too_many_lots | More than 100 items in one request. |