Rockvel API

Your code can do what the site does: read the market, list and buy items, and follow your deals. The API takes and answers JSON over HTTPS.

Base address

https://api.rockvel.store/v1

First request

  1. Make a key on the API key page. You sign in through Steam, and the key is yours.
  2. Send it with a request. This one asks who the key belongs to.
curl https://api.rockvel.store/v1/me -H "Authorization: Bearer $ROCKVEL_KEY"

The answer is your account and your balance.

{
  "user": {
    "steam_id": "76561198087654321",
    "name": "bluegem",
    "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
    "trade_url": "https://steamcommunity.com/tradeoffer/new/?partner=127388593&token=kZ3xQ9aB"
  },
  "balance": { "available_cents": 125000, "held_cents": 3250 }
}

What is in the API

Account
Your balance, your totals and your trade link.
Inventory
The copy of your inventory that lots are made from.
Market
Search items, read their lots and sellers' stalls.
Stall and lots
List items, change prices and take lots down.
Deals
Buy a lot, cancel a deal, open a dispute.
Auto-buy
Tell Rockvel what happens on Steam.

Versions

The address carries the version. Within v1 we only add: new routes, and new fields in answers. Ignore the fields you don't know and your program keeps working. A change that would break it gets a new version.