https://wiki.bconomy.net/w/index.php?action=history&feed=atom&title=Data_API%2FMarket
Data API/Market - Revision history
2026-11-06T04:34:00Z
Revision history for this page on the wiki
MediaWiki 1.46.2
https://wiki.bconomy.net/w/index.php?title=Data_API/Market&diff=468&oldid=prev
TheCarriedOne: Publish from docs/data-api.md
2026-11-02T12:19:58Z
<p>Publish from docs/data-api.md</p>
<p><b>New page</b></p><div><small>[[Data API|Data API]] · [[Data API/Types|Types]]</small><br />
<br />
== <code><nowiki>market/preview</nowiki></code> ==<br />
<br />
Returns the current lowest listing price and price delta for every item. Data is cached (refreshes approximately every 5 minutes).<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/preview" }</pre><br />
<br />
<strong>Response</strong><br />
<br />
<pre>{<br />
lastUpdated: number // Unix ms timestamp<br />
data: Record&lt;string, MarketPreviewItem&gt; // keyed by item idName<br />
}</pre><br />
<br />
== <code><nowiki>market/listings</nowiki></code> ==<br />
<br />
Returns up to 50 active market listings for an item, sorted by price ascending.<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/listings", "itemId": 5 }</pre><br />
<br />
<strong>Response</strong> — [[Data API/Types#MarketListing|<code><nowiki>MarketListing[]</nowiki></code>]]<br />
<br />
== <code><nowiki>market/userListings</nowiki></code> ==<br />
<br />
Returns all active market listings created by a user.<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/userListings", "id": 1 }</pre><br />
<br />
<strong>Response</strong> — [[Data API/Types#MarketListing|<code><nowiki>MarketListing[]</nowiki></code>]]<br />
<br />
== <code><nowiki>market/globalRecentActivity</nowiki></code> ==<br />
<br />
Returns the last 20 market transactions (buys, listings, and delistings) across all items. Results are cached for 10 seconds.<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/globalRecentActivity" }</pre><br />
<br />
<strong>Response</strong> — [[Data API/Types#MarketActivityEntry|<code><nowiki>MarketActivityEntry[]</nowiki></code>]]<br />
<br />
== <code><nowiki>market/recentTransactions</nowiki></code> ==<br />
<br />
Returns the last 5 market transactions for a specific item.<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/recentTransactions", "itemId": 5 }</pre><br />
<br />
<strong>Response</strong> — [[Data API/Types#MarketActivityEntry|<code><nowiki>MarketActivityEntry[]</nowiki></code>]]<br />
<br />
== <code><nowiki>market/priceHistory</nowiki></code> ==<br />
<br />
Returns historical lowest-price snapshots for an item.<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/priceHistory", "itemId": 5, "days": 30 }</pre><br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Type<br />
! Required<br />
! Notes<br />
|-<br />
| <code><nowiki>itemId</nowiki></code><br />
| number<br />
| yes<br />
| <br />
|-<br />
| <code><nowiki>fromMs</nowiki></code><br />
| non-negative integer<br />
| no<br />
| Unix ms start of range<br />
|-<br />
| <code><nowiki>toMs</nowiki></code><br />
| non-negative integer<br />
| no<br />
| Unix ms end of range<br />
|-<br />
| <code><nowiki>days</nowiki></code><br />
| positive integer<br />
| no<br />
| number of days back from now; alternative to fromMs/toMs<br />
|}<br />
<br />
<strong>Response</strong> — [[Data API/Types#MarketPriceSnapshot|<code><nowiki>MarketPriceSnapshot[]</nowiki></code>]] (sorted by <code><nowiki>snapshotTime</nowiki></code> ascending)<br />
<br />
== <code><nowiki>market/volumeHistory</nowiki></code> ==<br />
<br />
Returns aggregated trade volume history for an item.<br />
<br />
<strong>Request</strong><br />
<br />
<pre>{ "type": "market/volumeHistory", "itemId": 5, "granularity": "day", "days": 30 }</pre><br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Type<br />
! Required<br />
! Notes<br />
|-<br />
| <code><nowiki>itemId</nowiki></code><br />
| number<br />
| yes<br />
| <br />
|-<br />
| <code><nowiki>granularity</nowiki></code><br />
| <code><nowiki>"hour"</nowiki></code> &#124; <code><nowiki>"day"</nowiki></code> &#124; <code><nowiki>"month"</nowiki></code><br />
| yes<br />
| <br />
|-<br />
| <code><nowiki>days</nowiki></code><br />
| positive integer<br />
| no<br />
| max 400; defaults to server-configured value<br />
|}<br />
<br />
<strong>Response</strong> — [[Data API/Types#MarketVolumeSnapshot|<code><nowiki>MarketVolumeSnapshot[]</nowiki></code>]]<br />
<br />
<small>Generated from the Bconomy source documentation. Edits made on the wiki are overwritten on the next publish; ask the developers to change the source.</small><br />
<br />
[[Category:Data API]]</div>
TheCarriedOne