Skip to main content
POST
/
v2
/
currency-offers
Create a currency offer
curl --request POST \
  --url https://api.gameboost.com/v2/currency-offers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "game_id": 123,
  "description": "<string>",
  "price": 0.015,
  "currency": "EUR",
  "stock": 1000000,
  "min_quantity": 1000,
  "delivery_time": {
    "duration": 2,
    "unit": "hours"
  },
  "currency_data": {
    "server": "EU",
    "faction": "Alliance"
  },
  "game": "<string>",
  "delivery_instructions": "<string>"
}
'
{
  "data": {
    "id": 123,
    "uuid": "<string>",
    "game": {
      "id": 123,
      "name": "<string>",
      "slug": "<string>"
    },
    "currency_unit": {
      "slug": "<string>",
      "currency_name": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "multiplier": 123
    },
    "title": "<string>",
    "description": "<string>",
    "parameters": {},
    "base_currency": "<string>",
    "status": "draft",
    "delivery_time": {
      "duration": 123,
      "unit": "minutes",
      "format": "<string>",
      "format_long": "<string>",
      "seconds": 123
    },
    "delivery_instructions": "<string>",
    "stock": 123,
    "min_quantity": 123,
    "price_eur": "<string>",
    "price_usd": "<string>",
    "views": 123,
    "icon_url": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "listed_at": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
game_id
integer
required

Unique identifier for the game (required if game slug not provided)

​
description
string
required

Detailed description of the currency and how it will be delivered

Maximum string length: 5028
​
price
number
required

Price per currency unit, up to 6 decimal places

Example:

0.015

​
currency
enum<string>
default:EUR
required

Base currency code for pricing

Available options:
EUR,
USD
Example:

"EUR"

​
stock
integer
required

Available quantity of currency units in stock

Required range: 0 <= x <= 1000000000
Example:

1000000

​
min_quantity
integer
default:1
required

Minimum quantity that can be purchased in a single order

Required range: 1 <= x <= 1000000000
Example:

1000

​
delivery_time
object
required

Expected delivery time object

Example:
{ "duration": 2, "unit": "hours" }
​
currency_data
object
required

Specifics available via the template endpoint. Game-specific currency attributes such as server, realm, or faction

Example:
{ "server": "EU", "faction": "Alliance" }
​
game
string

Slug of the game (required if game_id not provided)

​
delivery_instructions
string

Special instructions for currency delivery, provided to buyer after purchase

Response

A single currency offer

​
data
object

Currency offer object representing in-game currency for sale