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>",
  "currency_unit": "fc-points",
  "currency_unit_id": 130,
  "external_id": "<string>",
  "volume_discounts": [
    {
      "min_quantity": 5000,
      "percent": 5
    },
    {
      "min_quantity": 10000,
      "percent": 10
    },
    {
      "min_quantity": 25000,
      "percent": 15
    }
  ],
  "delivery_instructions": "<string>",
  "excluded_delivery_fields": []
}
'

import requests

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

payload = {
    "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>",
    "currency_unit": "fc-points",
    "currency_unit_id": 130,
    "external_id": "<string>",
    "volume_discounts": [
        {
            "min_quantity": 5000,
            "percent": 5
        },
        {
            "min_quantity": 10000,
            "percent": 10
        },
        {
            "min_quantity": 25000,
            "percent": 15
        }
    ],
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>',
    currency_unit: 'fc-points',
    currency_unit_id: 130,
    external_id: '<string>',
    volume_discounts: [
      {min_quantity: 5000, percent: 5},
      {min_quantity: 10000, percent: 10},
      {min_quantity: 25000, percent: 15}
    ],
    delivery_instructions: '<string>',
    excluded_delivery_fields: []
  })
};

fetch('https://api.gameboost.com/v2/currency-offers', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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>',
    'currency_unit' => 'fc-points',
    'currency_unit_id' => 130,
    'external_id' => '<string>',
    'volume_discounts' => [
        [
                'min_quantity' => 5000,
                'percent' => 5
        ],
        [
                'min_quantity' => 10000,
                'percent' => 10
        ],
        [
                'min_quantity' => 25000,
                'percent' => 15
        ]
    ],
    'delivery_instructions' => '<string>',
    'excluded_delivery_fields' => [
        
    ]
  ]),
  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"

	payload := strings.NewReader("{\n  \"game_id\": 123,\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  },\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\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}")

	req, _ := http.NewRequest("POST", 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.post("https://api.gameboost.com/v2/currency-offers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"game_id\": 123,\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  },\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\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}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"game_id\": 123,\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  },\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\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}"

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": "The given data was invalid.",
  "errors": {
    "field": [
      "Something is wrong with this field!"
    ]
  }
}

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

Currency Offers

Create a currency offer

Create a new currency offer for sale with game-specific parameters, pricing, stock quantity, and delivery time. Some games have multiple currency units (for example FC 26: fc-coins and fc-points). Pass currency_unit (or currency_unit_id) from the template endpoint; if omitted, the game’s default unit is used. currency_data is validated per unit — load it with the same currency_unit. Offer uniqueness is scoped by currency unit. Volume discounts apply only to currency-style units (not top-up units such as Points).

POST

currency-offers

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>",
  "currency_unit": "fc-points",
  "currency_unit_id": 130,
  "external_id": "<string>",
  "volume_discounts": [
    {
      "min_quantity": 5000,
      "percent": 5
    },
    {
      "min_quantity": 10000,
      "percent": 10
    },
    {
      "min_quantity": 25000,
      "percent": 15
    }
  ],
  "delivery_instructions": "<string>",
  "excluded_delivery_fields": []
}
'

import requests

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

payload = {
    "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>",
    "currency_unit": "fc-points",
    "currency_unit_id": 130,
    "external_id": "<string>",
    "volume_discounts": [
        {
            "min_quantity": 5000,
            "percent": 5
        },
        {
            "min_quantity": 10000,
            "percent": 10
        },
        {
            "min_quantity": 25000,
            "percent": 15
        }
    ],
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>',
    currency_unit: 'fc-points',
    currency_unit_id: 130,
    external_id: '<string>',
    volume_discounts: [
      {min_quantity: 5000, percent: 5},
      {min_quantity: 10000, percent: 10},
      {min_quantity: 25000, percent: 15}
    ],
    delivery_instructions: '<string>',
    excluded_delivery_fields: []
  })
};

fetch('https://api.gameboost.com/v2/currency-offers', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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>',
    'currency_unit' => 'fc-points',
    'currency_unit_id' => 130,
    'external_id' => '<string>',
    'volume_discounts' => [
        [
                'min_quantity' => 5000,
                'percent' => 5
        ],
        [
                'min_quantity' => 10000,
                'percent' => 10
        ],
        [
                'min_quantity' => 25000,
                'percent' => 15
        ]
    ],
    'delivery_instructions' => '<string>',
    'excluded_delivery_fields' => [
        
    ]
  ]),
  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"

	payload := strings.NewReader("{\n  \"game_id\": 123,\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  },\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\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}")

	req, _ := http.NewRequest("POST", 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.post("https://api.gameboost.com/v2/currency-offers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"game_id\": 123,\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  },\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\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}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"game_id\": 123,\n  \"description\": \"<string>\",\n  \"price\": 0.015,\n  \"currency\": \"EUR\",\n  \"stock\": 1000000,\n  \"min_quantity\": 1000,\n  \"delivery_time\": {\n    \"duration\": 2,\n    \"unit\": \"hours\"\n  },\n  \"currency_data\": {\n    \"server\": \"EU\",\n    \"faction\": \"Alliance\"\n  },\n  \"game\": \"<string>\",\n  \"currency_unit\": \"fc-points\",\n  \"currency_unit_id\": 130,\n  \"external_id\": \"<string>\",\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}"

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": "The given data was invalid.",
  "errors": {
    "field": [
      "Something is wrong with this field!"
    ]
  }
}

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

Multi-unit games: Read template.currency_units, then request the template with ?currency_unit={slug} so currency_data matches that unit. The same parameters under Coins and Points are separate offers.

Example: create an FC 26 Points (top-up) offer

{
  "game": "fc-26",
  "currency_unit": "fc-points",
  "description": "Fast FC Points delivery",
  "price": 8.59,
  "currency": "EUR",
  "stock": 100,
  "min_quantity": 1,
  "delivery_method": "username",
  "delivery_time": {
    "duration": 10,
    "unit": "minutes"
  },
  "currency_data": {
    "game_device": "PC - no EA Membership",
    "fc_points": "5900 FC Points"
  }
}

Example: create an FC 26 Coins offer (default unit)

Omit currency_unit, or set "currency_unit": "fc-coins". Use Coins currency_data (e.g. platform).

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

Show child attributes

Example:

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

currency_data

object

required

Game- and unit-specific attributes. Always load them from the template endpoint, passing the same currency_unit you will create with.

Example:

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

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). If omitted, the game's default unit is used (for FC 26 that is Coins / fc-coins).

Example:

"fc-points"

currency_unit_id

integer

Currency unit id. Alternative to currency_unit. If omitted, the game's default unit is used.

Example:

130

external_id

string

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

Maximum string length: 255

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 when not used. 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

Response

A single currency offer

data

object

Currency offer object representing in-game currency for sale

Show child attributes

REST API

Webhooks

Create a currency offer

Example: create an FC 26 Points (top-up) offer

Example: create an FC 26 Coins offer (default unit)

Authorizations

Body

Response

​Example: create an FC 26 Points (top-up) offer

​Example: create an FC 26 Coins offer (default unit)

Authorizations

Body

Response

Example: create an FC 26 Points (top-up) offer

Example: create an FC 26 Coins offer (default unit)