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>",
  "external_id": "<string>",
  "delivery_instructions": "<string>"
}
'
{
  "data": {
    "id": 123,
    "uuid": "<string>",
    "external_id": "<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": "EUR",
    "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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gameboost.com/llms.txt

Use this file to discover all available pages before exploring further.

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. Interpreted in the currency specified by the currency field (defaults to EUR). USD values are converted to EUR before storage.

Example:

0.015

currency
enum<string>
default:EUR
required

Currency the price is expressed in. EUR is stored as-is; USD is converted to EUR server-side. Defaults to EUR.

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)

external_id
string

External identifier for the currency offer, used to map to your own system

Maximum string length: 255
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