Account data types

Characters and warehouse

Character

Field	Type	Description
id	ID!	Character ID
name	String!	Name
level	Int!	Level
classId	Int!	Class ID
className	String!	Class name
clanName	String	Clan name
online	Boolean!	Online state
karma	Int!	Karma
pkKills	Int!	PK kills
pvpKills	Int!	PvP kills
sex	Int!	Gender
lastAccess	DateTime	Last login

CharacterItem

Field	Type	Description
id	ID!	Inventory object ID
itemId	Int!	Item type ID
name	String!	Name
count	Int!	Quantity
enchantLevel	Int!	Enchant level
icon	String	Icon
augmentation	String	Augmentation
attributes	JSON	Attributes

CharacterOwner

Field	Type	Description
accountLogin	String!	Game account login
character	Character!	Character

WarehouseItem

Field	Type	Description
id	ID!	Record ID
itemId	Int!	Item ID
name	String!	Name
count	Int!	Quantity
enchantLevel	Int!	Enchant level
icon	String	Icon
status	Int!	Delivery state
giveType	Int!	Delivery method
createdAt	DateTime!	Creation time
deliveredAt	DateTime	Delivery time

PurchaseResult

Field	Type	Description
message	String	Message
item	WarehouseItem	Delivered item
balance	Float	Updated balance
bonusBalance	Float	Updated bonus balance
warehouse	[WarehouseItem!]	Updated warehouse

ServiceResult

Field	Type	Description
message	String	Message
balance	Float	Updated balance
bonusBalance	Float	Updated bonus balance

Player marketplace

All marketplace money and quantity values are strings. This preserves DECIMAL(20, 6) and large game-stack precision on every client.

MarketplaceConfiguration

Field	Type	Description
enabled	Boolean!	Marketplace state
gameServerId	Int!	Game server
currency	MarketplaceCurrency!	Marketplace currency
version	String!	Published configuration version
listingPolicy	MarketplaceListingPolicy!	Global listing rules
paymentSources	[MarketplacePaymentSourceDefinition!]!	Payment sources
sections	[MarketplaceSection!]!	Catalog sections
sellerTiers	[MarketplaceSellerTier!]!	Seller tiers
transfers	MarketplaceTransferConfiguration!	Main-balance transfers
withdrawals	MarketplaceWithdrawalConfiguration!	External withdrawals

MarketplaceListingPolicy

Field	Type	Description
sellerFeeBasisPoints	Int!	Seller fee in basis points
minimumPrice / maximumPrice	String! / String	Price range
maximumAssetsPerListing	Int!	Assets per listing
maximumActiveListings	Int!	Active listing limit
itemModerationRequired	Boolean!	Item moderation
characterModerationRequired	Boolean!	Character moderation
stackableItemsAllowed	Boolean!	Stackable items
augmentedItemsAllowed	Boolean!	Augmented items
attributedItemsAllowed	Boolean!	Attributed items
sellerTiersEnabled	Boolean!	Seller tiers

MarketplaceWithdrawalMethod

Field	Type	Description
code / name	String!	Code and localized name
instructions	String	Player instructions
destinationKind	String!	Destination kind
destinationFields	[MarketplaceWithdrawalDestinationField!]!	Published form schema
minimumAmount / maximumAmount	String	Method limits
feeBasisPoints	Int	Method fee
payoutCurrencyCode	String!	Payout currency

MarketplaceWithdrawalDestinationField.type is TEXT, EMAIL, PHONE, or SELECT. The field also publishes required, length limits, a safe pattern, and select options.

MarketplaceCatalogConnection

Field	Type	Description
nodes	[MarketplaceCatalogOffer!]!	Current page
pageInfo	MarketplaceCursorPageInfo!	Opaque cursors and next-page flag
totalCount	Int!	All published offers
filteredCount	Int!	Offers after filters

MarketplaceCatalogOffer

Field	Type	Description
id / listingId	ID!	Offer and listing
section	MarketplaceCatalogSection!	Section
saleMode	MarketplaceListingSaleMode!	Sale mode
title / description	String	Seller text
unitPrice / currencyCode	String!	Unit price and currency
availableUnits	String!	Available units
minimumPurchaseUnits / maximumPurchaseUnits	String! / String	Purchase limits
asset	MarketplaceCatalogAsset!	Primary asset
publishedAt	DateTime!	Publication time

MarketplaceCatalogAsset

Field	Type	Description
type	MarketplaceAssetType!	ITEM or CHARACTER
itemId	ID	Game item ID
name	String!	Current parsed catalog name or character name
additionalName	String	Current item subtitle
gradeCode	String	Current grade
icon / panelIcon	String	Safe local images
enchantLevel	Int!	Enchant level
modifiers	MarketplaceItemModifiers	Augmentation and attributes
character	MarketplaceCharacterSnapshot	Character state at listing time
characterInventory	[MarketplaceCharacterInventoryItem!]	Character inventory with current item presentation

If the parsed item catalog entry is absent, the API does not fall back to a stored display_name; it fails the read as a data-integrity error.

MarketplaceListing

Field	Type	Description
id	ID!	Public listing ID
section	MarketplaceListingSection!	Section
saleMode	MarketplaceListingSaleMode!	Sale mode
publicationState	MarketplaceListingPublicationState!	Publication lifecycle
moderationState	MarketplaceListingModerationState!	Moderation lifecycle
title / description	String	Seller text
sellerFeeBasisPoints	Int!	Captured seller fee
offers	[MarketplaceOffer!]!	Purchase variants
publishedAt	DateTime!	Publication time

MarketplaceOffer contains an exact unit price, available units, purchase limits, and [MarketplaceOfferAsset!]! quantities per purchased unit.

MarketplaceViewer

Field	Type	Description
gameServerId	Int!	Session-selected server
addonActive	Boolean!	Project owns an active add-on
configurationPresent / configurationEnabled	Boolean!	Configuration state
currency	MarketplaceCurrency	Currency or null without configuration
capabilities	MarketplaceAccountCapabilities!	Server decision for each action
restrictions	[MarketplaceRestrictionScope!]!	Active restrictions
seller	MarketplaceSellerProfile!	Limits, fee, and tier
wallets	[MarketplaceWallet!]!	Available and reserved balances
statistics	MarketplaceAccountStatistics!	Purchases, sales, and turnover

MarketplaceActionCapability contains allowed and reason. Reasons are ADDON_INACTIVE, CONFIGURATION_MISSING, CONFIGURATION_DISABLED, SELL_RESTRICTED, PURCHASE_RESTRICTED, PAYMENT_SOURCES_UNAVAILABLE, WITHDRAWAL_RESTRICTED, ACTIVE_LISTING_LIMIT_REACHED, NO_CANCELLABLE_LISTINGS, MAIN_BALANCE_TRANSFERS_DISABLED, EXTERNAL_WITHDRAWALS_DISABLED, and WITHDRAWAL_METHODS_UNAVAILABLE.

MarketplaceSellerListing

Seller listings additionally expose:

• endedReason, moderationNote, and canCancel;
• exact originalQuantity, reservedQuantity, deliveredQuantity, and returnedQuantity values for every asset;
• totalUnits, reservedUnits, soldUnits, and availableUnits for offers;
• publishedAt, suspendedAt, endedAt, createdAt, and updatedAt.

MarketplaceOrder

Field	Type	Description
id	ID!	Order
role	MarketplaceOrderRole!	Current player's role
outcome	MarketplaceOrderOutcome!	Order outcome
grossAmount	String!	Gross amount
sellerFeeAmount	String!	Seller fee
sellerNetAmount	String!	Seller proceeds
payment	MarketplaceOrderPayment!	Payment source and lifecycle
lines	[MarketplaceOrderLine!]!	Assets, delivery, and settlement
completedAt / cancelledAt	DateTime	Terminal timestamps

Payment, delivery, and settlement are independent lifecycles. They cannot be derived from one generic status.

MarketplaceWalletEntry

Field	Type	Description
type	MarketplaceWalletEntryType!	Movement type
sourceType	MarketplaceWalletEntrySourceType!	Operation source
sourceReference	ID	Public source reference
availableDelta / reservedDelta	String!	Balance changes
availableBalanceAfter / reservedBalanceAfter	String!	Post-entry balance
currencyCode	String!	Currency
occurredAt	DateTime!	Posting time

MarketplaceBalanceTransfer

Field	Type	Description
id	ID!	Transfer
state	MarketplaceBalanceTransferState!	Lifecycle
amount / currencyCode	String!	Amount and currency
completedAt / reversalStartedAt / reversedAt	DateTime	Transition times
createdAt / updatedAt	DateTime!	Record times

MarketplaceWithdrawal

Field	Type	Description
id	ID!	Withdrawal
method	MarketplaceWithdrawalMethodSummary!	Method
reviewState	MarketplaceWithdrawalReviewState!	Review
payoutState	MarketplaceWithdrawalPayoutState!	Payout
fundsState	MarketplaceWithdrawalFundsState!	Funds
sourceAmount / feeAmount / netSourceAmount	String!	Source calculation
conversionRate / payoutAmount	String!	Conversion and payout
sourceCurrencyCode / payoutCurrencyCode	String!	Currencies
destinationPreview	String!	Masked destination
reviewReasonCode / payoutReference	String	Decision and payout reference
lifecycle timestamps	DateTime	Review, payout, and cancellation

Mutation submissions

Type	Purpose
MarketplaceListingSubmission	requestId, listing, publication, moderation, and offer IDs
MarketplacePurchaseSubmission	requestId, order, outcome, payment, and settlement
MarketplaceListingCancellationSubmission	Ended listing and returned quantity
MarketplaceBalanceTransferSubmission	Created transfer, amount, and state
MarketplaceWithdrawalSubmission	Created withdrawal and complete payout calculation

Lifecycles

Enum	Values
MarketplaceListingSaleMode	BUNDLE, INDIVIDUAL, CHARACTER
MarketplaceListingPublicationState	UNPUBLISHED, PUBLISHED, SUSPENDED, ENDED
MarketplaceListingModerationState	NOT_REQUIRED, PENDING, APPROVED, REJECTED
MarketplaceListingEndReason	SOLD_OUT, WITHDRAWN_BY_SELLER, REJECTED_BY_MODERATOR, REMOVED_BY_ADMIN
MarketplacePaymentSource	MAIN_BALANCE, MARKETPLACE_WALLET
MarketplaceOrderOutcome	OPEN, COMPLETED, CANCELLED
MarketplacePaymentState	PENDING, CAPTURED, REFUNDING, REFUNDED, CANCELLED
MarketplaceDeliveryState	PENDING, DELIVERING, DELIVERED, RETURNING, RETURNED, CANCELLED
MarketplaceSettlementState	PENDING, POSTED, REVERSING, REVERSED, CANCELLED
MarketplaceBalanceTransferState	PROCESSING, COMPLETED, REVERSING, REVERSED
MarketplaceWithdrawalReviewState	PENDING, APPROVED, REJECTED
MarketplaceWithdrawalPayoutState	NOT_STARTED, PROCESSING, PAID, CANCELLED
MarketplaceWithdrawalFundsState	RESERVED, SETTLED, RELEASED, FROZEN