Inventory & Bank

Inventory

Each character has 20 slots in their inventory, which can hold a maximum of 100 items. So you can have 20 different items, but a maximum of 100 items in total. At each level, the maximum total items increases by 2.

JSON

....
"inventory": [
  {
    "slot": 0,
    "code": "string",
    "quantity": 0
    }
]

Bags

Your character can equip a bag to increase the size of their inventory in the bag_slot slot.

Here are some examples of bags you can equip:

Loading items...

Retrieving Character Data

You can view a character, including their inventory, using this request:

Endpoint: GET /characters/{name}

cURL

curl --request GET \
--url 'https://api.artifactsmmo.com/characters/YOUR_CHARACTER_NAME' \
--header 'Accept: application/json'

JavaScript

const url = 'https://api.artifactsmmo.com/characters/YOUR_CHARACTER_NAME';
const options = {
method: 'GET',
headers: {
  Accept: 'application/json'
}
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/characters/YOUR_CHARACTER_NAME"
headers = {"Accept": "application/json"}

response = requests.get(url, headers=headers)
print(response.json())

View the API Reference

---

Bank

At the bank, you can deposit items and gold. The bank is shared with all your characters, it’s the best way to trade with your other characters.

The bank is limited to 50 slots, but you can buy expansions to add 20 slots. The first expansion costs 3,500 gold, and the price doubles (x2) with each expansion purchased, capped at 448,000 gold.

View bank items

You can view the contents of your bank at any time using the following request:

Endpoint: GET /my/bank/items

cURL

curl --location --request GET 'https://api.artifactsmmo.com/my/bank/items' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN'

JavaScript

const url = 'https://api.artifactsmmo.com/my/bank/items';
const options = {
method: 'GET',
headers: {
  'Accept': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/bank/items"
headers = {
  "Accept": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

View the API Reference

Get bank details

You can also view general information about your bank (total gold, slots, expansions, next expansion cost) using the following request:

Endpoint: GET /my/bank

cURL

curl --location --request GET 'https://api.artifactsmmo.com/my/bank' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN'

JavaScript

const url = 'https://api.artifactsmmo.com/my/bank';
const options = {
method: 'GET',
headers: {
  'Accept': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/bank"
headers = {
  "Accept": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

View the API Reference

Deposit items

To deposit items, you must be on a map containing a bank. For more details on map navigation, see Maps and Movement.

Note

There is a 3-second cooldown per different item deposit.

To deposit items, use the following request:

Endpoint: POST /my/{name}/action/bank/deposit/item

cURL

curl --request POST \
--url https://api.artifactsmmo.com/my/{name}/action/bank/deposit/item \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '[
  { "code": "string", "quantity": 1 },
  { "code": "another_item", "quantity": 2 }
]'

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/bank/deposit/item';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
},
body: JSON.stringify([
  { code: "string", quantity: 1 },
  { code: "another_item", quantity: 2 }
])
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/{name}/action/bank/deposit/item"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}
data = [
  {"code": "string", "quantity": 1},
  {"code": "another_item", "quantity": 2}
]

response = requests.post(url, json=data, headers=headers)
print(response.json())

View the API Reference

Field	Description
code	The item code to deposit.
quantity	Number of items to deposit.

Withdraw items

To withdraw items, you must be on a map containing a bank. For more details on map navigation, see Maps and Movement.

Note

There is a 3-second cooldown per different item withdrawn.

To withdraw items, use the following request:

Endpoint: POST /my/{name}/action/bank/withdraw/item

cURL

curl --request POST \
--url https://api.artifactsmmo.com/my/{name}/action/bank/withdraw/item \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '[
  { "code": "string", "quantity": 1 },
  { "code": "another_item", "quantity": 2 }
]'

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/bank/withdraw/item';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
},
body: JSON.stringify([
  { code: "string", quantity: 1 },
  { code: "another_item", quantity: 2 }
])
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/{name}/action/bank/withdraw/item"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}
data = [
  {"code": "string", "quantity": 1},
  {"code": "another_item", "quantity": 2}
]

response = requests.post(url, json=data, headers=headers)
print(response.json())

View the API Reference

Field	Description
code	The item code to withdraw.
quantity	Number of items to withdraw.

Withdraw Gold

To withdraw gold, you must be on a map containing a bank. For more details on map navigation, see Maps and Movement. You can withdraw any amount of gold per request.

To withdraw gold, use the following request:

Endpoint: POST /my/{name}/action/bank/withdraw/gold

cURL

curl --request POST \
--url https://api.artifactsmmo.com/my/{name}/action/bank/withdraw/gold \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"quantity": 1
}'

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/bank/withdraw/gold';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
},
body: '{"quantity":1}'
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/{name}/action/bank/withdraw/gold"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}
data = {"quantity": 1}

response = requests.post(url, json=data, headers=headers)
print(response.json())

View the API Reference

Field	Description
quantity	Amount of gold to withdraw.

Deposit gold

To deposit gold, you must be on a map containing a bank. For more details on map navigation, see Maps and Movement. You can deposit any amount of gold per request, as long as you have the gold available.

To deposit gold, use the following request:

Endpoint: POST /my/{name}/action/bank/deposit/gold

cURL

curl --request POST \
--url https://api.artifactsmmo.com/my/{name}/action/bank/deposit/gold \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"quantity": 1
}'

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/bank/deposit/gold';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
},
body: '{"quantity":1}'
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/{name}/action/bank/deposit/gold"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}
data = {"quantity": 1}

response = requests.post(url, json=data, headers=headers)
print(response.json())

View the API Reference

Field	Description
quantity	Amount of gold to deposit.

Buy expansion

To buy an expansion, you need to be on a map containing a bank. It adds 20 slots, starts at 3,500 gold, and the price doubles (x2) with each expansion purchased, capped at 448,000 gold.

To buy an expansion, use the following request:

Endpoint: POST /my/{name}/action/bank/buy_expansion

cURL

curl --request POST \
--url https://api.artifactsmmo.com/my/{name}/action/bank/buy_expansion \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/bank/buy_expansion';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
}
};

try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}

Python

import requests

url = "https://api.artifactsmmo.com/my/{name}/action/bank/buy_expansion"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

response = requests.post(url, headers=headers)
print(response.json())

View the API Reference