API/v2/commerce/listings

/v2/commerce/listings

HTTP-Methode

GET

Format

JSON

API-Version

Version 2

Dieser Endpunkt liefert die Gegenstand Preise des Handelsposten zurück.

Parameter

• ids (number) – Kommagetrennte Liste an Gegenstand-IDs.

Ein Einzelner Gegenstand kann auch als Subendpunkt angefragt werden. Beispiel: /2/commerce/listings/12345.

Antwort

Wenn der Endpunkt ohne Gegenstand-IDs abgefragt wird (/2/commerce/listings), wird eine Liste aller verfügbaren Gegenstand-IDs zurückgegeben. Wenn mehrere Gegenstände mit dem ids Parameter angefordert werden, wird ein Objekt mit mehreren Listings zurückgegeben.

Für jede angeforderte ID wird folgendes zurückgegeben:

• id (number) – Die Gegenstand-ID.
• buys (array) – Einer Liste aller Kaufgebote, absteigend geordnet von dem höchsten Kaufgebot (max. 20 Einträge).
• sells (array) – Eine Liste alle Angebote, aufsteigend geordnet von dem niedrigsten Angebot (max. 20 Einträge).

Jedes Listing-Objekt enthält folgende Werte:

• listings (number) – Anzahl an Gegenständen in diesem Listing (z.B. zwei Spieler die zum selben Preis verkaufen sind in einem Listing zusammengefasst)
• unit_price (number) – Der Gold Preis in Kupfer.
• quantity (number) – Die Anzahl der Gegenstände die bestellt/verkauft werden.

Beispiel

http://api.guildwars2.com/v2/commerce/listings/19684

{
    "id": 19684,
    "buys": [
        {
            "listings": 5,
            "unit_price": 72,
            "quantity": 1004
        },
        {
            "listings": 16,
            "unit_price": 70,
            "quantity": 4000
        },
        {
            "listings": 37,
            "unit_price": 68,
            "quantity": 9083
        },

        …

    ],
    "sells": [
        {
            "listings": 1,
            "unit_price": 73,
            "quantity": 22
        },
        {
            "listings": 1,
            "unit_price": 99,
            "quantity": 118
        },
        {
            "listings": 12,
            "unit_price": 100,
            "quantity": 2230
        },

        …

    ]
}

http://api.guildwars2.com/v2/commerce/listings?ids=19684,19709

[
    {
        "id": 19684,
        "buys": [
            {
                "listings": 4,
                "unit_price": 72,
                "quantity": 820
            },
            {
                "listings": 6,
                "unit_price": 71,
                "quantity": 1500
            },

            …

        ],
        "sells": [
            {
                "listings": 2,
                "unit_price": 73,
                "quantity": 234
            },
            {
                "listings": 1,
                "unit_price": 99,
                "quantity": 118
            },

            …

        ]
    },
    {
        "id": 19709,
        "buys": [
            {
                "listings": 1,
                "unit_price": 33,
                "quantity": 155
            },
            {
                "listings": 31,
                "unit_price": 32,
                "quantity": 7586
            },

            …

        ],
        "sells": [
            {
                "listings": 11,
                "unit_price": 46,
                "quantity": 1080
            },
            {
                "listings": 3,
                "unit_price": 48,
                "quantity": 320
            },

            …

        ]
    }
]