Developers · API v1

Steam top up API for shops and bots

Top up Steam wallets by login straight from your shop, Telegram bot or CRM. One POST request places the order from your USD credit; the answer carries the order code and the price, and the status follows with GET. Prices are the same as on the site, $0.8843 per wallet dollar.

Read the quick start Get an API key

Request

POST /api/v1/orders
Authorization: Bearer stk_live_...

{
  "login": "gamer_alex2009",
  "amount": "20.00"
}

201 Created

{
  "ok": true,
  "order": {
    "id": "SO-7KQ2M9XH4C",
    "login": "gamer_alex2009",
    "amount": "20.00",
    "price": "17.69",
    "status": "processing"
  }
}

One POST places the order

Bearer key from your account

Free price endpoint, no key

Status by order code

Quick start

curl -X POST https://steamtopup.io/api/v1/orders \
  -H "Authorization: Bearer stk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"login":"gamer_alex2009","amount":"20.00"}'

A new order answers status processing. Read GET /api/v1/orders/{id} until it says done, or refunded if it could not be delivered (the price is then back on your credit). GET /api/v1/price returns the exact price before any charge. Limits: 300 requests per minute per key; amounts $0.65 to $850 per order.

Endpoints

Method	Path	Auth	What it does
GET	/api/v1/price?amount=20	No key	Price and KZT/UAH estimates for an amount
GET	/api/v1/regions	No key	Supported countries and wallet currencies
GET	/api/v1/balance	Key	Credit balance in USD
POST	/api/v1/orders	Key	Place a top-up: login and amount
GET	/api/v1/orders/{id}	Key	Status of one order
GET	/api/v1/orders	Key	Your latest 100 orders

Errors

HTTP	error	Meaning	Credit charged
400	bad_login	Login format is not a Steam login name	No
400	bad_amount	Amount outside $0.65 to $850	No
401	unauthorized	Missing or wrong API key	No
402	funds	Credit is lower than the price (need = missing USD)	No
429	rate_limited	More than 300 requests per minute	No
503	network	The top-up could not be sent right now; try again later	No

Who it's for

Game shops and Telegram bots

Sell Steam top-ups in your own store or bot, take payment your way and let the API deliver to the customer's Steam login.

Resellers

Buy from a USD credit balance and resell with your own margin. The price endpoint tells you the cost of any amount before the order.

CRM and automation

Add Steam wallet rewards to loyalty programmes, tournaments and giveaways: one HTTP call per winner.

Gaming clubs and communities

Fund members' accounts from one balance with a clear order history per login.