getMarketBoardCurrentData

suspend fun getMarketBoardCurrentData(world: World, itemId: Int, listings: Int? = null, entries: Int? = null, noGst: Boolean? = null, hq: Boolean? = null, statsWithin: Int? = null, entriesWithin: Int? = null): CurrentlyShown

Returns the data currently shown on the market board for the requested item ID and World.

Parameters

world

The World to retrieve data for.

itemId

The item ID to retrieve data for.

listings

The number of listings to return. By default, all listings will be returned.

entries

The number of recent history entries to return. By default, a maximum of 5 entries will be returned.

noGst

If the result should not have Gil sales tax (GST) factored in. GST is applied to all consumer purchases in-game, and is separate from the retainer city tax that impacts what sellers receive. By default, GST is factored in.

hq

Filter for HQ listings and entries. By default, both HQ and NQ listings and entries will be returned.

statsWithin

The amount of time before now to calculate stats over, in milliseconds. By default, this is 7 days.

entriesWithin

The amount of time before now to take entries within, in seconds. Negative values will be ignored.

Throws

The item requested is invalid.

The Universalis API returned an unexpected return code.


suspend fun getMarketBoardCurrentData(dataCenter: DataCenter, itemId: Int, listings: Int? = null, entries: Int? = null, noGst: Boolean? = null, hq: Boolean? = null, statsWithin: Int? = null, entriesWithin: Int? = null): CurrentlyShown

Returns the data currently shown on the market board for the requested item ID and DataCenter.

Parameters

dataCenter

The DataCenter to retrieve data for.

itemId

The item ID to retrieve data for.

listings

The number of listings to return. By default, all listings will be returned.

entries

The number of recent history entries to return. By default, a maximum of 5 entries will be returned.

noGst

If the result should not have Gil sales tax (GST) factored in. GST is applied to all consumer purchases in-game, and is separate from the retainer city tax that impacts what sellers receive. By default, GST is factored in.

hq

Filter for HQ listings and entries. By default, both HQ and NQ listings and entries will be returned.

statsWithin

The amount of time before now to calculate stats over, in milliseconds. By default, this is 7 days.

entriesWithin

The amount of time before now to take entries within, in seconds. Negative values will be ignored.

Throws

The item requested is invalid.

The Universalis API returned an unexpected return code.


suspend fun getMarketBoardCurrentData(region: Region, itemId: Int, listings: Int? = null, entries: Int? = null, noGst: Boolean? = null, hq: Boolean? = null, statsWithin: Int? = null, entriesWithin: Int? = null): CurrentlyShown

Returns the data currently shown on the market board for the requested item ID and Region.

Parameters

region

The Region to retrieve data for.

itemId

The item ID to retrieve data for.

listings

The number of listings to return. By default, all listings will be returned.

entries

The number of recent history entries to return. By default, a maximum of 5 entries will be returned.

noGst

If the result should not have Gil sales tax (GST) factored in. GST is applied to all consumer purchases in-game, and is separate from the retainer city tax that impacts what sellers receive. By default, GST is factored in.

hq

Filter for HQ listings and entries. By default, both HQ and NQ listings and entries will be returned.

statsWithin

The amount of time before now to calculate stats over, in milliseconds. By default, this is 7 days.

entriesWithin

The amount of time before now to take entries within, in seconds. Negative values will be ignored.

Throws

The item requested is invalid.

The Universalis API returned an unexpected return code.


suspend fun getMarketBoardCurrentData(world: World, itemIds: IntArray, listings: Int? = null, entries: Int? = null, noGst: Boolean? = null, hq: Boolean? = null, statsWithin: Int? = null, entriesWithin: Int? = null): Multi<CurrentlyShown>

Returns the data currently shown on the market board for the requested array of item IDs and World.

Parameters

world

The World to retrieve data for.

itemIds

The array of item IDs to retrieve data for.

listings

The number of listings to return. By default, all listings will be returned.

entries

The number of recent history entries to return. By default, a maximum of 5 entries will be returned.

noGst

If the result should not have Gil sales tax (GST) factored in. GST is applied to all consumer purchases in-game, and is separate from the retainer city tax that impacts what sellers receive. By default, GST is factored in.

hq

Filter for HQ listings and entries. By default, both HQ and NQ listings and entries will be returned.

statsWithin

The amount of time before now to calculate stats over, in milliseconds. By default, this is 7 days.

entriesWithin

The amount of time before now to take entries within, in seconds. Negative values will be ignored.

Throws

The Universalis API returned an unexpected return code.


suspend fun getMarketBoardCurrentData(dataCenter: DataCenter, itemIds: IntArray, listings: Int? = null, entries: Int? = null, noGst: Boolean? = null, hq: Boolean? = null, statsWithin: Int? = null, entriesWithin: Int? = null): Multi<CurrentlyShown>

Returns the data currently shown on the market board for the requested array of item IDs and DataCenter.

Parameters

dataCenter

The DataCenter to retrieve data for.

itemIds

The array of item IDs to retrieve data for.

listings

The number of listings to return. By default, all listings will be returned.

entries

The number of recent history entries to return. By default, a maximum of 5 entries will be returned.

noGst

If the result should not have Gil sales tax (GST) factored in. GST is applied to all consumer purchases in-game, and is separate from the retainer city tax that impacts what sellers receive. By default, GST is factored in.

hq

Filter for HQ listings and entries. By default, both HQ and NQ listings and entries will be returned.

statsWithin

The amount of time before now to calculate stats over, in milliseconds. By default, this is 7 days.

entriesWithin

The amount of time before now to take entries within, in seconds. Negative values will be ignored.

Throws

The Universalis API returned an unexpected return code.


suspend fun getMarketBoardCurrentData(region: Region, itemIds: IntArray, listings: Int? = null, entries: Int? = null, noGst: Boolean? = null, hq: Boolean? = null, statsWithin: Int? = null, entriesWithin: Int? = null): Multi<CurrentlyShown>

Returns the data currently shown on the market board for the requested array of item IDs and Region.

Parameters

region

The Region to retrieve data for.

itemIds

The array of item IDs to retrieve data for.

listings

The number of listings to return. By default, all listings will be returned.

entries

The number of recent history entries to return. By default, a maximum of 5 entries will be returned.

noGst

If the result should not have Gil sales tax (GST) factored in. GST is applied to all consumer purchases in-game, and is separate from the retainer city tax that impacts what sellers receive. By default, GST is factored in.

hq

Filter for HQ listings and entries. By default, both HQ and NQ listings and entries will be returned.

statsWithin

The amount of time before now to calculate stats over, in milliseconds. By default, this is 7 days.

entriesWithin

The amount of time before now to take entries within, in seconds. Negative values will be ignored.

Throws

The Universalis API returned an unexpected return code.