Offers

Get offers on a players items

For each provided item belonging to the player, will return the best offer which has been placed in the Mythical Marketplace.

post

/v1/players/{playerId}/offers

Authorizations

Path parameters

playerIdstring · uuidrequired

UUID of the player to find offers for

Header parameters

Authorizationstring · Bearer {bearerToken}required

Bearer token to be passed for Authorization. Can be retrieved from v1/auth/token

x-mythical-environment-idstring · uuidrequired

Identifier for the environment that this request should interact with

Body

itemsstring · uuid[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/players/{playerId}/offers' \
  --header 'Authorization: text' \
  --header 'x-mythical-environment-id: 123e4567-e89b-12d3-a456-426614174000' \
  --header 'Content-Type: application/json' \
  --data '{
    "items": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }'

200

200

{
  "mythToUsd": 0.33,
  "offers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "priceUSD": 1,
      "feeUSD": 1,
      "priceMYTH": 1,
      "feeMYTH": 1,
      "version": 1,
      "item": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
        "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
        "tokenId": 1,
        "state": "pending",
        "metadataUrl": "http://url.com/1",
        "metadata": {
          "name": "text",
          "description": "text",
          "image": "text",
          "attributes": [
            {
              "type": "string",
              "value": "attrValue",
              "displayType": "number, boolean, string",
              "maxValue": 255
            }
          ]
        }
      }
    }
  ]
}

Offers and other data

Accept an offer

Accept the specified offer from the Mythical Marketplace on behalf of the given player. Will only succeed if the provided mythToUsd rate has not deviated too far from when the price was quoted, and the version of the offer has not changed.

post

/v1/offers/{id}/accept

Authorizations

Path parameters

idstringrequired

UUID of the offer to accept

Header parameters

Authorizationstring · Bearer {bearerToken}required

Bearer token to be passed for Authorization. Can be retrieved from v1/auth/token

x-mythical-environment-idstring · uuidrequired

Identifier for the environment that this request should interact with

Body

playerIdstring · uuid

versionnumber

Example: 1

mythToUSDnumber

Example: 0.33

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/offers/{id}/accept' \
  --header 'Authorization: text' \
  --header 'x-mythical-environment-id: 123e4567-e89b-12d3-a456-426614174000' \
  --header 'Content-Type: application/json' \
  --data '{
    "playerId": "123e4567-e89b-12d3-a456-426614174000",
    "version": 1,
    "mythToUSD": 0.33
  }'

200

200

{
  "traceId": "f4e5d3a4-2a9b-4d9f-bc5a-73b3f0c47b5e"
}

Response with traceId.