Skip to main content

Marketplace

Player-to-player item marketplace: listing, buying, searching, and redeeming credits.

C→S 2407 - RequestOffers

Nitro: MARKETPLACE_REQUEST_OFFERS

Source: RequestOffersEvent, GetMarketplaceOffersMessageComposer

Requests the marketplace item listings matching given price range, search query, and type filters.

Body:
min: int
max: int
query: string

C→S 848 - RequestSellItem

Nitro: REQUEST_SELL_ITEM

Source: RequestSellItemEvent, GetMarketplaceCanMakeOfferComposer

Requests whether the current user can list a specific item for sale on the marketplace.

Body: (empty)

C→S 3447 - SellItem

Nitro: MARKETPLACE_SELL_ITEM

Source: SellItemEvent, MakeOfferMessageComposer

Lists a furniture item for sale on the marketplace at a specified credit price.

Body:
credits: int
1 = FLOOR_TYPE, 2 = WALL_TYPE: int

C→S 434 - TakeBackItem

Nitro: MARKETPLACE_TAKE_BACK_ITEM

Source: TakeBackItemEvent, CancelMarketplaceOfferMessageComposer

Removes (cancels) an active marketplace listing by offer ID, returning the item to inventory.

Body: (empty)

C→S 1603 - BuyItem

Nitro: MARKETPLACE_BUY_OFFER

Source: BuyItemEvent, BuyMarketplaceOfferMessageComposer

Purchases a marketplace listing by offer ID.

Body: (empty)

C→S 2105 - RequestOwnItems

Nitro: MARKETPLACE_REQUEST_OWN_ITEMS

Source: RequestOwnItemsEvent, GetMarketplaceOwnOffersMessageComposer

Requests the list of the current user's active marketplace listings.

Body: (empty)

C→S 3288 - RequestItemInfo

Nitro: REQUEST_MARKETPLACE_ITEM_STATS

Source: RequestItemInfoEvent, GetMarketplaceItemStatsComposer

Requests price history and statistics for a specific marketplace item.

Body:
readInt: int

C→S 2650 - RequestCredits

Nitro: MARKETPLACE_REDEEM_CREDITS

Source: RequestCreditsEvent, RedeemMarketplaceOfferCreditsMessageComposer

Requests redemption of Marketplace credits (also used as a credit balance refresh in some contexts).

Body: (empty)

C→S 2597 - RequestMarketplaceConfig

Nitro: MARKETPLACE_CONFIG

Source: RequestMarketplaceConfigEvent, GetMarketplaceConfigurationMessageComposer

FieldTypeNotes
(empty)-No body fields read

Notes: Requests the marketplace configuration. Response is MARKETPLACE_CONFIG (S→C 1823).

Requests marketplace configuration (fee rates, credit value).


C→S 398 - RequestRecyclerLogic

Nitro: RECYCLER_PRIZES

Source: RequestRecyclerLogicEvent

FieldTypeNotes
(empty)-No body fields read

Notes: Requests the recycler prize configuration.

Requests recycler machine data (prizes, status).


C→S 3498 - GetSoundMachinePlaylist

Nitro: GET_SOUND_MACHINE_PLAYLIST Note: No Arcturus handler at this ID - Nitro only. Source: GetSoundMachinePlayListMessageComposer

Requests the Sound Machine playlist for the current room. Nitro-only.

Body: (empty)

Requests the Sound Machine playlist for the current room. No parameters.

C→S 3846 - JukeBoxThree

Nitro: (no Nitro constant)

Source: JukeBoxEventThree

FieldTypeNotes
(body not confirmed)-Third jukebox interaction event - Arcturus-only, no Nitro mapping

Sends a jukebox control or playlist action (exact purpose depends on context).


C→S 872 - RentableSpaceStatus

Nitro: RENTABLE_SPACE_STATUS Note: No Arcturus handler - Nitro only. Source: RentableSpaceStatusMessageComposer

FieldTypeNotes
itemIdintFurniture item ID of the rentable space to query

Requests the current rental status of a rentable space furniture item.

C→S 1071 - RentableExtendRentOrBuyoutFurni

Nitro: RENTABLE_EXTEND_RENT_OR_BUYOUT_FURNI Note: No Arcturus handler - Nitro only. Source: ExtendRentOrBuyoutFurniMessageComposer

FieldTypeNotes
isWallbooltrue if the item is a wall item
roomInstanceIdintRoom instance (object) ID of the rentable furniture
isBuyoutbooltrue to buy out, false to extend rent

Extends the rental or completes the buyout for a rentable furniture item.

C→S 1866 - MarketplaceBuyTokens

Nitro: MARKETPLACE_BUY_TOKENS Note: No Arcturus handler - Nitro only. Source: BuyMarketplaceTokensMessageComposer

Requests purchase of Marketplace tokens. Nitro-only.

Body: (empty)

Requests purchase of Marketplace tokens. No parameters.

C→S 2115 - RentableExtendRentOrBuyoutStripItem

Nitro: RENTABLE_EXTEND_RENT_OR_BUYOUT_STRIP_ITEM Note: No Arcturus handler - Nitro only. Source: ExtendRentOrBuyoutStripItemMessageComposer

FieldTypeNotes
stripIdintStrip item ID of the rentable furniture
isBuyoutbooltrue to buy out, false to extend rent

Extends the rental or buyout for a strip (wall) rentable item.

C→S 2518 - RentableGetRentOrBuyoutOffer

Nitro: RENTABLE_GET_RENT_OR_BUYOUT_OFFER Note: No Arcturus handler - Nitro only. Source: GetRentOrBuyoutOfferMessageComposer

FieldTypeNotes
isWallbooltrue if the item is a wall furniture
furnitureFullNamestringFull furniture class name used to identify rentable item
isBuyoutbooltrue to request buyout price, false for rent price

Requests the rent/buyout offer details for a rentable space item.

C→S 3959 - PhotoCompetition

Nitro: PHOTO_COMPETITION Note: No Arcturus handler - Nitro only. Source: PhotoCompetitionMessageComposer

Body: (empty)

Sends an anonymous photo to the current room's competition. No parameters.

Submits the current user's room photo to a competition. Nitro-only.

S→C 3878 - CameraPrice

Nitro: INIT_CAMERA

Source: CameraPriceComposer, InitCameraMessageEvent

FieldTypeNotes
creditsintCredit cost to purchase a photo print
pointsintActivity point cost
pointsTypeintActivity point type (currency type ID)

Delivers the credit cost for publishing or purchasing a room photo.


S→C 3696 - CameraURL

Nitro: CAMERA_STORAGE_URL

Source: CameraURLComposer, CameraStorageUrlMessageEvent

FieldTypeNotes
urlstringURL of the saved photo on the camera service

Delivers the camera service base URL for photo upload/display.

S→C 1927 - CameraRoomThumbnailSaved

Nitro: THUMBNAIL_UPDATE_RESULT

Source: CameraRoomThumbnailSaved, RoomThumbnailUpdateResultEvent

FieldTypeNotes
(empty)-No body fields

Notes: Sent after a room thumbnail is successfully saved.

Confirms that the room thumbnail photo was saved successfully.

S→C 2057 - CameraPublishWaitMessage

Nitro: CAMERA_PUBLISH_STATUS

Source: CameraPublishWaitMessageComposer, CameraPublishStatusMessageEvent

FieldTypeNotes
isOkbooleanWhether the publish was accepted
cooldownSecondsintSeconds until next publish is allowed
extraDataIdstringExtra data ID (conditional - only if isOk is true)

Notifies the client to wait while the photo is being published to the camera service.

S→C 2783 - CameraPurchaseSuccesfull

Nitro: CAMERA_PURCHASE_OK

Source: CameraPurchaseSuccesfullComposer, CameraPurchaseOKMessageEvent

FieldTypeNotes
(empty)-No body fields

Notes: Sent after successfully purchasing a camera photo print.

Confirms that a photo purchase was successful.

S→C 463 - CameraSnapshot

Nitro: CAMERA_SNAPSHOT Note: No Arcturus composer - Nitro only. Source: CameraSnapshotMessageEvent

(no Arcturus composer)

Delivers a camera snapshot request to the client.

FieldTypeNotes
roomTypestringRoom type string (e.g. "private")
roomIdintRoom ID to snapshot

Notifies the client that a snapshot was taken (used for animation trigger).

S→C 3595 - ThumbnailStatus

Nitro: THUMBNAIL_STATUS Note: No Arcturus composer - Nitro only. Source: CameraRoomThumbnailSavedComposer, ThumbnailStatusMessageEvent

(no Arcturus composer)

Delivers the room thumbnail upload status. Body is parsed by ThumbnailStatusMessageEvent.

Delivers the upload status for a room thumbnail image. Nitro-only.

Body: (empty)

S→C 1823 - MarketplaceConfig

Nitro: MARKETPLACE_CONFIG

Source: MarketplaceConfigComposer, MarketplaceConfigurationEvent

FieldTypeNotes
enabledbooleanAlways true
commissionPctintCommission percentage (always 1)
creditsMultiplierintAlways 10
advertisementsMultiplierintAlways 5
minPriceintMinimum listing price (always 1)
maxPriceintMaximum listing price (always 1,000,000)
hoursInMarketplaceintHours a listing stays active (always 48)
daysToDisplayintDays listings remain searchable (always 7)

Delivers marketplace configuration (commission rates, credit value, sell enabled flag).

S→C 680 - MarketplaceOffers

Nitro: MARKETPLACE_ITEMS_SEARCHED

Source: MarketplaceOffersComposer, MarketPlaceOffersEvent

FieldTypeNotes
offerCountintNumber of marketplace offers
offers[]repeatedPer offer: offerId:int, unknown:int(1), type:int, itemId:int, [limitedNumber+limitedStack:int×2 if limited], extraData:string, unknown2:int(0), extraData2:string, salePrice:int, unknown3:int(0)

Delivers a paginated list of marketplace listings matching a search.

S→C 3884 - MarketplaceOwnItems

Nitro: MARKETPLACE_OWN_ITEMS

Source: MarketplaceOwnItemsComposer, MarketplaceOwnOffersEvent

FieldTypeNotes
totalSoldValueintTotal credits earned from past sales
listingCountintNumber of active listings
listings[]repeatedPer listing: offerId:int, state:int, type:int, itemId:int, [limitedNumber+limitedStack if limited], extraData:string, unknown:int(0), extraData2:string, price:int

Delivers the list of the user's own active marketplace listings.


S→C 54 - MarketplaceSellItem

Nitro: MARKETPLACE_SELL_ITEM

Source: MarketplaceSellItemComposer, MarketplaceCanMakeOfferResult

FieldTypeNotes
errorCodeintResult code
valueAintContext value A
valueBintContext value B

Delivers the result of attempting to list an item on the marketplace - success or error code with context values.

S→C 1359 - MarketplaceItemPosted

Nitro: MARKETPLACE_ITEM_POSTED

Source: MarketplaceItemPostedComposer, MarketplaceMakeOfferResult

FieldTypeNotes
codeintResult code (0 = success)

Confirms that a marketplace listing was successfully posted, returning a result code.

S→C 3264 - MarketplaceCancelSale

Nitro: MARKETPLACE_CANCEL_SALE

Source: MarketplaceCancelSaleComposer, MarketplaceCancelOfferResultEvent

FieldTypeNotes
offerIdintID of the cancelled listing
successbooleanWhether cancellation succeeded

Delivers the result of cancelling a marketplace listing, with the offer ID and a success flag.

S→C 725 - MarketplaceItemStats

Nitro: MARKETPLACE_ITEM_STATS Note: No Arcturus composer - Nitro only. Source: MarketplaceItemInfoComposer, MarketplaceItemStatsEvent

FieldTypeNotes
averagePriceintAverage sale price over the history period
currentOfferCountintNumber of current active offers
historyLengthintNumber of days of price history
countintNumber of price history entries
[count × dayOffset]intDay offset (0=today, 1=yesterday, etc.)
[count × avgPrice]intAverage sale price for this day
[count × soldAmount]intNumber of items sold on this day
furniCategoryIdintFurniture category ID
furniTypeIdintFurniture type (class) ID

Delivers price history and current offer statistics for a marketplace item type. Nitro-only.

S→C 2032 - MarketplaceAfterOrderStatus

Nitro: MARKETPLACE_AFTER_ORDER_STATUS Note: No Arcturus composer - Nitro only. Source: MarketplaceBuyErrorComposer, MarketplaceBuyOfferResultEvent

FieldTypeNotes
resultintPurchase result code
newOfferIdintNew offer ID (if the original was updated)
newPriceintNew price (if the offer price changed)
requestedOfferIdintThe offer ID that was originally requested

Delivers the result of a marketplace buy attempt, including updated offer ID and price if changed. Nitro-only.

S→C 618 - CraftingResult

Nitro: CRAFTING_RESULT

Source: CraftingResultComposer, CraftingResultEvent

FieldTypeNotes
successbooleanWhether crafting succeeded
recipeNamestringName of the crafted recipe (only if success)
rewardNamestringName of the resulting item (only if success)

Delivers the result of a crafting attempt - success flag, recipe name, and resulting item name.

S→C 1000 - CraftableProducts

Nitro: CRAFTABLE_PRODUCTS

Source: CraftableProductsComposer, CraftableProductsEvent

FieldTypeNotes
recipeCountintNumber of known recipes
recipes[]repeatedPer recipe: recipeName:string, rewardName:string
ingredientCountintNumber of unique ingredient items
ingredients[]string[]Ingredient item names

Delivers all known crafting recipes and their required ingredient item names.

S→C 2124 - CraftingRecipesAvailable

Nitro: CRAFTING_RECIPES_AVAILABLE

Source: CraftingRecipesAvailable, CraftingRecipesAvailableEvent

FieldTypeNotes
countintNumber of available recipes (adjusted: −1 if found, else count)
foundbooleanWhether the combination matched a known recipe

Notifies the client how many crafting recipes match the current ingredient combination and whether an exact match was found.

S→C 2774 - CraftingRecipe

Nitro: CRAFTING_RECIPE

Source: CraftingRecipeComposer, CraftingRecipeEvent

FieldTypeNotes
ingredientCountintNumber of ingredients in this recipe
ingredients[]repeatedPer ingredient: count:int, itemName:string

Delivers the ingredient list (item names and counts) for a specific crafting recipe.


S→C 2602 - JukeBoxMySongs

Nitro: USER_SONG_DISKS_INVENTORY

Source: JukeBoxMySongsComposer, UserSongDisksInventoryMessageEvent

FieldTypeNotes
itemCountintNumber of music disc items in inventory
items[]repeatedPer item: itemId:int, songId:int

Delivers the user's personal music disc inventory for the jukebox panel.


S→C 1112 - YoutubeDisplayList

Nitro: YOUTUBE_DISPLAY_PLAYLISTS

Source: YoutubeDisplayListComposer, YoutubeDisplayPlaylistsEvent

FieldTypeNotes
itemIdintID of the YouTube TV furniture item
playlistCountintNumber of playlists
playlists[]repeatedPer playlist: playlistId:string, title:string, description:string
currentPlaylistIdstringID of the currently active playlist (empty if none)

Delivers the list of YouTube playlists configured for a YouTube TV furniture item.

S→C 1411 - YoutubeVideo

Nitro: YOUTUBE_DISPLAY_VIDEO

Source: YoutubeVideo, YoutubeDisplayVideoMessageEvent

FieldTypeNotes
itemIdintID of the YouTube TV furniture item
videoIdstringYouTube video ID
startTimeintStart position in seconds
durationintTotal video duration in seconds
stateint1 = playing, 2 = paused

Delivers the current YouTube video playing on a YouTube TV furniture item.

S→C 1554 - YoutubeStateChange

Nitro: YOUTUBE_CONTROL_VIDEO

Source: YoutubeStateChange, YoutubeControlVideoMessageEvent

FieldTypeNotes
furniIdintID of the YouTube TV furniture item
stateintNew playback state

Notifies clients that the playback state of a YouTube TV furniture item has changed (e.g. play, pause, stop).