Skip to main content
POST

Authorizations

Authorization
string
header
required

Your API key, from the cabinet under Seller → API keys.

Body

application/json

Which of these are required depends on the category — read requirements from its schema. The rest are optional everywhere.

game
string

The game's slug.

category
string

The category's slug.

title
string
Required string length: 8 - 128
description
string
Maximum string length: 4096
price
integer<int64>

Minor units of the platform currency. Ignored for a bulk (per-unit) listing, which prices off price_per_unit instead.

currency
string

The platform currency, or omitted. Anything else is refused.

attributes
object

The category's own fields, keyed by the schema's key.

images
string<uri>[]

URLs minted by POST /v1/offers/images/upload-url. Nothing else is accepted.

tags
string[]
delivery_type
enum<string>
Available options:
instant,
manual
delivery_method
string

A key from GET /v1/offers/delivery-methods.

seller_instructions
string

What the buyer is told about the handoff, in your words.

Maximum string length: 2048
units
object[]

Instant delivery only — one opaque JSON payload per unit, the goods themselves. Encrypted at rest; never read back by this API.

manual_delivery_value
integer

Manual delivery only — the handoff time you promise.

manual_delivery_unit
enum<string>
Available options:
minutes,
hours,
days
manual_delivery_instructions
string
Maximum string length: 2048
product_slug
string

Bulk listings only — from .../products.

price_per_unit
integer<int64>

Bulk listings only. Per one of the product's scale, not per coin.

stock_quantity
integer<int64>

Bulk listings only.

min_order_quantity
integer<int64>

Bulk listings only — the smallest order you will take.

Response

Created

Your own listing, as the write calls answer with it.

id
string<uuid>
seller_id
string<uuid>
title
string
description
string
price
integer<int64>
currency
string
attributes
object
images
string<uri>[]
tags
string[]
delivery_type
enum<string>
Available options:
instant,
manual
manual_delivery_value
integer | null
manual_delivery_unit
string | null
manual_delivery_instructions
string | null
status
enum<string>
Available options:
draft,
pending_moderation,
active,
paused,
reserved,
sold,
rejected,
removed,
archived
created_at
string<date-time> | null
updated_at
string<date-time> | null
published_at
string<date-time> | null
rejection_reason_code
string | null

Why moderation refused it, when it did.

rejection_note
string | null
seller_instructions
string
delivery_method
string | null
price_per_unit
integer<int64> | null
stock_quantity
integer<int64> | null
min_order_quantity
integer<int64> | null
product_id
string<uuid> | null