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 - RedeemMarketplaceCredits​

Nitro: MARKETPLACE_REDEEM_CREDITS

Source: RequestCreditsEvent, RedeemMarketplaceOfferCreditsMessageComposer

Redeem all sold trades at the marketplace. 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 - CameraPurchaseSuccessful​

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).