Buy a marketplace item
const url = 'https://api.gampeon.com/v1/resources/example/purchase';const options = { method: 'POST', headers: { 'Idempotency-Key': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"expectedPrice":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.gampeon.com/v1/resources/example/purchase \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: example' \ --data '{ "expectedPrice": 1 }'Send the price you were shown as expectedPrice. Bought and gifted GAMPEONS are used first (oldest purchase first), then earned ones. The creator share is credited as pending.
Not available with access tokens.
Rate limit: 60 per hour per account.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Resource name
Header Parameters
Section titled “Header Parameters”Required. 8 to 100 characters (A-Z a-z 0-9 _ - : .). The same key with the same body returns the stored answer (replayed: true) without booking again.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Price shown to the buyer
Example generated
{ "expectedPrice": 1}Responses
Section titled “Responses”Bought
object
Amount in GAMPEONS
object
off: payments are switched off. sandbox: payments are simulated, no real money moves.
object
Bought or gifted. Spendable, never paid out
Earned, still in the holding period
Earned. Spendable and can be paid out
Reserved for a payout request
Wallet + earned
Locked after a chargeback. Buying, spending and payouts are blocked
Seller terms accepted, prices can be set
Creator shares that unlock next
object
Unix time in milliseconds
Amount in GAMPEONS
object
Euro cents
Spent or in open orders in the last 30 days
object
Creator share of each sale in basis points (7000 = 70 %)
Payout per earned GAMPEON in millionths of a euro (3800 = €0.0038)
Minimum payout
Days before a creator share can be spent or paid out
Days to withdraw from an unused purchase
Most an account can spend on GAMPEONS in 30 days
Lowest price for an item
Highest price for an item
Example
{ "owned": true, "wallet": { "mode": "off", "payoutProgram": "none" }}Error codes: invalid_field, idempotency_key_required
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}Error codes: unauthorized
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}Error codes: token_not_allowed, wallet_locked
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}Error codes: not_found
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}Error codes: free_item, own_item, price_changed, already_owned, insufficient_funds, idempotency_conflict
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}Limit: 60 per hour per account. Error codes: rate_limited
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}Error codes: payments_disabled
object
Machine-readable error code, for example not_found or rate_limited.
Human-readable detail. Only present for some errors.
Example generated
{ "error": "example", "message": "example"}