Update a currency offer

curl --request PATCH \
  --url https://api.gameboost.com/v2/currency-offers/{currencyOffer} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "game_id": 123,
  "game": "<string>",
  "currency_unit": "fc-points",
  "currency_unit_id": 130,
  "external_id": "<string>",
  "description": "<string>",
  "price": 0.015,
  "currency": "EUR",
  "stock": 1000000,
  "min_quantity": 1000,
  "volume_discounts": [
    {
      "min_quantity": 5000,
      "percent": 5
    },
    {
      "min_quantity": 10000,
      "percent": 10
    },
    {
      "min_quantity": 25000,
      "percent": 15
    }
  ],
  "delivery_instructions": "<string>",
  "excluded_delivery_fields": [],
  "delivery_time": {
    "duration": 2,
    "unit": "hours"
  },
  "currency_data": {
    "server": "EU",
    "faction": "Alliance"
  }
}
'

import requests

url = "https://api.gameboost.com/v2/currency-offers/{currencyOffer}"

payload = {
    "game_id": 123,
    "game": "<string>",
    "currency_unit": "fc-points",
    "currency_unit_id": 130,
    "external_id": "<string>",
    "description": "<string>",
    "price": 0.015,
    "currency": "EUR",
    "stock": 1000000,
    "min_quantity": 1000,
    "volume_discounts": [
        {
            "min_quantity": 5000,
            "percent": 5
        },
        {
            "min_quantity": 10000,
            "percent": 10
        },
        {
            "min_quantity": 25000,
            "percent": 15
        }
    ],
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": [],
    "delivery_time": {
        "duration": 2,
        "unit": "hours"
    },
    "currency_data": {
        "server": "EU",
        "faction": "Alliance"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    game_id: 123,
    game: '<string>',
    currency_unit: 'fc-points',
    currency_unit_id: 130,
    external_id: '<string>',
    description: '<string>',
    price: 0.015,
    currency: 'EUR',
    stock: 1000000,
    min_quantity: 1000,
    volume_discounts: [
      {min_quantity: 5000, percent: 5},
      {min_quantity: 10000, percent: 10},
      {min_quantity: 25000, percent: 15}
    ],
    delivery_instructions: '<string>',
    excluded_delivery_fields: [],
    delivery_time: {duration: 2, unit: 'hours'},
    currency_data: {server: 'EU', faction: 'Alliance'}
  })
};

fetch('https://api.gameboost.com/v2/currency-offers/{currencyOffer}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gameboost.com/v2/currency-offers/{currencyOffer}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'game_id' => 123,
    'game' => '<string>',
    'currency_unit' => 'fc-points',
    'currency_unit_id' => 130,
    'external_id' => '<string>',
    'description' => '<string>',
    'price' => 0.015,
    'currency' => 'EUR',
    'stock' => 1000000,
    'min_quantity' => 1000,
    'volume_discounts' => [
        [
                'min_quantity' => 5000,
                'percent' => 5
        ],
        [
                'min_quantity' => 10000,
                'percent' => 10
        ],
        [
                'min_quantity' => 25000,
                'percent' => 15
        ]
    ],
    'delivery_instructions' => '<string>',
    'excluded_delivery_fields' => [
        
    ],
    'delivery_time' => [
        'duration' => 2,
        'unit' => 'hours'
    ],
    'currency_data' => [
        'server' => 'EU',
        'faction' => 'Alliance'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gameboost.com/v2/currency-offers/{currencyOffer}"

	payload := strings.NewReader("{\n  \"game_id\": 123,\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"volume_discounts\": [\n    {\n      \"min_quantity\": 5000,\n      \"percent\": 5\n    },\n    {\n      \"min_quantity\": 10000,\n      \"percent\": 10\n    },\n    {\n      \"min_quantity\": 25000,\n      \"percent\": 15\n    }\n  ],\n  \"delivery_instructions\": \"<string>\",\n  \"excluded_delivery_fields\": [],\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.gameboost.com/v2/currency-offers/{currencyOffer}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"game_id\": 123,\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"volume_discounts\": [\n    {\n      \"min_quantity\": 5000,\n      \"percent\": 5\n    },\n    {\n      \"min_quantity\": 10000,\n      \"percent\": 10\n    },\n    {\n      \"min_quantity\": 25000,\n      \"percent\": 15\n    }\n  ],\n  \"delivery_instructions\": \"<string>\",\n  \"excluded_delivery_fields\": [],\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gameboost.com/v2/currency-offers/{currencyOffer}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"game_id\": 123,\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"volume_discounts\": [\n    {\n      \"min_quantity\": 5000,\n      \"percent\": 5\n    },\n    {\n      \"min_quantity\": 10000,\n      \"percent\": 10\n    },\n    {\n      \"min_quantity\": 25000,\n      \"percent\": 15\n    }\n  ],\n  \"delivery_instructions\": \"<string>\",\n  \"excluded_delivery_fields\": [],\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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",
    "delivery_time": {
      "duration": 123,
      "format": "<string>",
      "format_long": "<string>",
      "seconds": 123
    },
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": [],
    "delivery_method_data": {},
    "stock": 123,
    "min_quantity": 123,
    "volume_discounts": [
      {
        "min_quantity": 5000,
        "percent": 5
      },
      {
        "min_quantity": 10000,
        "percent": 10
      }
    ],
    "has_volume_discounts": true,
    "price_eur": "<string>",
    "price_usd": "<string>",
    "views": 123,
    "is_best_offer": true,
    "icon_url": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "listed_at": 123
  }
}

{
  "message": "Unauthenticated."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "Resource not found."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "Something is wrong with this field!"
    ]
  }
}

{
  "message": "Too many requests."
}

PATCH

currency-offers

{currencyOffer}

Update a currency offer

curl --request PATCH \
  --url https://api.gameboost.com/v2/currency-offers/{currencyOffer} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "game_id": 123,
  "game": "<string>",
  "currency_unit": "fc-points",
  "currency_unit_id": 130,
  "external_id": "<string>",
  "description": "<string>",
  "price": 0.015,
  "currency": "EUR",
  "stock": 1000000,
  "min_quantity": 1000,
  "volume_discounts": [
    {
      "min_quantity": 5000,
      "percent": 5
    },
    {
      "min_quantity": 10000,
      "percent": 10
    },
    {
      "min_quantity": 25000,
      "percent": 15
    }
  ],
  "delivery_instructions": "<string>",
  "excluded_delivery_fields": [],
  "delivery_time": {
    "duration": 2,
    "unit": "hours"
  },
  "currency_data": {
    "server": "EU",
    "faction": "Alliance"
  }
}
'

import requests

url = "https://api.gameboost.com/v2/currency-offers/{currencyOffer}"

payload = {
    "game_id": 123,
    "game": "<string>",
    "currency_unit": "fc-points",
    "currency_unit_id": 130,
    "external_id": "<string>",
    "description": "<string>",
    "price": 0.015,
    "currency": "EUR",
    "stock": 1000000,
    "min_quantity": 1000,
    "volume_discounts": [
        {
            "min_quantity": 5000,
            "percent": 5
        },
        {
            "min_quantity": 10000,
            "percent": 10
        },
        {
            "min_quantity": 25000,
            "percent": 15
        }
    ],
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": [],
    "delivery_time": {
        "duration": 2,
        "unit": "hours"
    },
    "currency_data": {
        "server": "EU",
        "faction": "Alliance"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    game_id: 123,
    game: '<string>',
    currency_unit: 'fc-points',
    currency_unit_id: 130,
    external_id: '<string>',
    description: '<string>',
    price: 0.015,
    currency: 'EUR',
    stock: 1000000,
    min_quantity: 1000,
    volume_discounts: [
      {min_quantity: 5000, percent: 5},
      {min_quantity: 10000, percent: 10},
      {min_quantity: 25000, percent: 15}
    ],
    delivery_instructions: '<string>',
    excluded_delivery_fields: [],
    delivery_time: {duration: 2, unit: 'hours'},
    currency_data: {server: 'EU', faction: 'Alliance'}
  })
};

fetch('https://api.gameboost.com/v2/currency-offers/{currencyOffer}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gameboost.com/v2/currency-offers/{currencyOffer}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'game_id' => 123,
    'game' => '<string>',
    'currency_unit' => 'fc-points',
    'currency_unit_id' => 130,
    'external_id' => '<string>',
    'description' => '<string>',
    'price' => 0.015,
    'currency' => 'EUR',
    'stock' => 1000000,
    'min_quantity' => 1000,
    'volume_discounts' => [
        [
                'min_quantity' => 5000,
                'percent' => 5
        ],
        [
                'min_quantity' => 10000,
                'percent' => 10
        ],
        [
                'min_quantity' => 25000,
                'percent' => 15
        ]
    ],
    'delivery_instructions' => '<string>',
    'excluded_delivery_fields' => [
        
    ],
    'delivery_time' => [
        'duration' => 2,
        'unit' => 'hours'
    ],
    'currency_data' => [
        'server' => 'EU',
        'faction' => 'Alliance'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gameboost.com/v2/currency-offers/{currencyOffer}"

	payload := strings.NewReader("{\n  \"game_id\": 123,\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"volume_discounts\": [\n    {\n      \"min_quantity\": 5000,\n      \"percent\": 5\n    },\n    {\n      \"min_quantity\": 10000,\n      \"percent\": 10\n    },\n    {\n      \"min_quantity\": 25000,\n      \"percent\": 15\n    }\n  ],\n  \"delivery_instructions\": \"<string>\",\n  \"excluded_delivery_fields\": [],\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.gameboost.com/v2/currency-offers/{currencyOffer}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"game_id\": 123,\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"volume_discounts\": [\n    {\n      \"min_quantity\": 5000,\n      \"percent\": 5\n    },\n    {\n      \"min_quantity\": 10000,\n      \"percent\": 10\n    },\n    {\n      \"min_quantity\": 25000,\n      \"percent\": 15\n    }\n  ],\n  \"delivery_instructions\": \"<string>\",\n  \"excluded_delivery_fields\": [],\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gameboost.com/v2/currency-offers/{currencyOffer}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"game_id\": 123,\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"volume_discounts\": [\n    {\n      \"min_quantity\": 5000,\n      \"percent\": 5\n    },\n    {\n      \"min_quantity\": 10000,\n      \"percent\": 10\n    },\n    {\n      \"min_quantity\": 25000,\n      \"percent\": 15\n    }\n  ],\n  \"delivery_instructions\": \"<string>\",\n  \"excluded_delivery_fields\": [],\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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",
    "delivery_time": {
      "duration": 123,
      "format": "<string>",
      "format_long": "<string>",
      "seconds": 123
    },
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": [],
    "delivery_method_data": {},
    "stock": 123,
    "min_quantity": 123,
    "volume_discounts": [
      {
        "min_quantity": 5000,
        "percent": 5
      },
      {
        "min_quantity": 10000,
        "percent": 10
      }
    ],
    "has_volume_discounts": true,
    "price_eur": "<string>",
    "price_usd": "<string>",
    "views": 123,
    "is_best_offer": true,
    "icon_url": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "listed_at": 123
  }
}

{
  "message": "Unauthenticated."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "Resource not found."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "Something is wrong with this field!"
    ]
  }
}

{
  "message": "Too many requests."
}

Changing currency_unit on an existing offer is usually not what you want. Create a new offer under the other unit instead. If you update currency_data, it must match the offer’s current unit schema from the template.

Authorizations

Authorization

string

header

required

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

Path Parameters

currencyOffer

string

required

The ID of the currency offer. Can be retrieved from the list of currency offers.

Body

application/json

Update currency offer - all fields are optional, only provide fields you want to update

game_id

integer

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

game

string

Slug of the game (required if game_id not provided)

currency_unit

string

Currency unit slug from template.currency_units (e.g. fc-coins, fc-points). Optional.

Example:

"fc-points"

currency_unit_id

integer

Currency unit id. Alternative to currency_unit. Optional.

Example:

130

external_id

string

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

Maximum string length: 255

description

string

Detailed description of the currency and how it will be delivered

Maximum string length: 5028

price

number

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

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

Available quantity of currency units in stock

Required range: 0 <= x <= 1000000000

Example:

1000000

min_quantity

integer

default:1

Minimum quantity that can be purchased in a single order

Required range: 1 <= x <= 1000000000

Example:

1000

volume_discounts

object[]

Optional volume discount tiers for currency games only (not top-ups). Max 3 tiers. Each tier percent is 1–50. Each tier min_quantity must be an integer >= 1, greater than the offer min_quantity, and unique across tiers. Omit to leave existing tiers unchanged. Send an empty array [] to remove all tiers. Only include this field when setting or clearing tiers. Sending this field for a top-up game returns 422 with error: "Volume discounts are only available for currency offers, not top-ups."

Maximum array length: 3

Show child attributes

Example:

[
  { "min_quantity": 5000, "percent": 5 },
  { "min_quantity": 10000, "percent": 10 },
  { "min_quantity": 25000, "percent": 15 }
]

delivery_instructions

string

Special instructions for currency delivery, provided to buyer after purchase

delivery_method

enum<string> | null

Optional delivery method. If null, legacy currency precheckout behavior is used.

Available options:

none,

username,

login,

trade,

auction,

gift,

redeem,

mail

excluded_delivery_fields

enum<string>[] | null

Optional delivery fields disabled by the seller. Required fields for the selected method cannot be excluded.

Available options:

username,

server,

login,

password,

platform,

region

delivery_time

object

Expected delivery time object

Show child attributes

Example:

{ "duration": 2, "unit": "hours" }

currency_data

object

Game- and unit-specific attributes. Always load them from the template endpoint, passing the same currency_unit as the offer. If you update currency_data, it must match the offer's current unit schema from the template.

Example:

{ "server": "EU", "faction": "Alliance" }

Response

A single currency offer

data

object

Currency offer object representing in-game currency for sale

Show child attributes

REST API

Webhooks

Update a currency offer

Authorizations

Path Parameters

Body

Response