Skills

Your characters have 8 skills that can gain XP and reach up to level 50. They allow you to gather resources and craft items.

Skill	Type	Description
Woodcutting	Gathering, Crafting	Harvesting wood from trees and crafting planks
Mining	Gathering, Crafting	Extracting ores from rocks and crafting ingots.
Fishing	Gathering	Catching fish from water sources.
Alchemy	Gathering, Crafting	Collecting plants and crafting potions.
Weaponcrafting	Crafting	Forging weapons for combat.
Gearcrafting	Crafting	Creating armor and equipment.
Jewelrycrafting	Crafting	Crafting rings and amulets.
Cooking	Crafting	Preparing food for healing.

Retrieving Character Skills

You can view a character, including their skills, 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

Gathering

Gathered resources are the foundation of the crafting system, as they are essential for almost every crafting recipe in the game. To gather a resource, your character must be located on a map tile that contains it. For more details on map navigation, see Maps and Movement.

Here are some examples of resources:

Loading resources...

XP Formula

Gathering XP is calculated with resource level and your skill level. In the formula, player_level means the level of the skill used to gather, rather than your combat level. Round rounds to the nearest integer, with halves rounded up.

XP = Round((XP_base + (resource_level / player_level) × 8) × level_penalty × wisdom_bonus)

XP Base (XP_base):

Resource Level	XP Base
< 10	5
10-19	10
20-29	13
30-34	16
35-39	20
40-44	28
45+	36

Level Penalty (level_penalty):

• Up to 10 levels above the resource → 1.0 (no additional penalty)
• More than 10 levels above the resource → 0 (0 XP)

Wisdom Bonus (wisdom_bonus):

• Formula: (1 + wisdom × 0.001)
• Each wisdom point = +0.1% XP

During Season 9, an active altar favor for this exact resource node multiplies the rounded XP by 1.5, then rounds again. It cannot restore XP lost to the level penalty.

Retrieving Resources

All resources

To retrieve a paginated list of all resources, use the following endpoint:

Endpoint: GET /resources

cURL

curl --request GET \
--url 'https://api.artifactsmmo.com/resources?page=1&size=50' \
--header 'Accept: application/json'

JavaScript

const url = 'https://api.artifactsmmo.com/resources?page=1&size=50';
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/resources"
response = requests.get(url, params={"page": 1, "size": 50})
print(response.json())

View the API Reference

Resource by Code

To retrieve specific resource details using its unique code, use the following endpoint:

Endpoint: GET /resources/{code}

cURL

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

JavaScript

const url = 'https://api.artifactsmmo.com/resources/copper_rocks';
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/resources/copper_rocks"
headers = {"Accept": "application/json"}

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

View the API Reference

Gather Action

To gather a resource, use the following endpoint:

Endpoint: POST /my/{name}/action/gathering

cURL

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

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/gathering';
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/gathering"
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

Crafting

Crafting is an essential core mechanic; the vast majority of items in the game—including equipment, jewelry, weapons, potions, and food—are entirely player-crafted. To craft an item, your character must be on a map tile with a workshop for the matching skill. For more information about maps, see Maps and Movement.

XP Formula

Crafting XP is calculated from the item level, your crafting skill level, and the total number of material units consumed by one craft:

player_level means your level in the recipe’s skill, and item_level is the recipe’s required skill level (craft.level). This Season 9 formula weights recipes by their material cost to make crafting progression smoother.

XP = Round((XP_base + (item_level / player_level) × coefficient) × crafting_multiplier × level_penalty × wisdom_bonus)

XP Base (XP_base) & Coefficient (coefficient):

Item Level	XP Base	Coefficient
< 5	50	25
5-9	100	30
10-14	200	35
15-19	325	40
20-24	450	45
25-29	550	50
30-34	650	55
35-39	750	60
40-44	850	65
45+	1000	70

Crafting Multiplier (crafting_multiplier):

For Cooking, Alchemy, Weaponcrafting, Gearcrafting, and Jewelrycrafting:

ingredient_count = Sum(quantity of each material in the recipe)
crafting_multiplier = Clamp(0.2832 + 0.2171 × √Max(1, ingredient_count), 0.50, 1.55)

ingredient_count is the total quantity of materials consumed by one craft, not the number of distinct material types. For example, a recipe requiring 10 bars and 5 pieces of wood has an ingredient_count of 15. The result quantity of the recipe does not change this value.

The square root makes expensive recipes grant more XP without allowing very large recipes to scale linearly. The multiplier is limited to a minimum of 0.50 and a maximum of 1.55.

Material units	Crafting multiplier
1	0.50
3	0.66
6	0.82
10	0.97
15	1.12
20	1.25
25	1.37
30	1.47

Mining and Woodcutting refining recipes use a fixed crafting multiplier of 0.1 instead of the ingredient-based formula.

For example, at skill level 20 with a level 20 recipe and no wisdom, the base is 450 + (20 / 20) × 45 = 495 XP:

Material units per craft	XP per craft
1	248
3	326
20	621
30	729

XP is rounded per craft, then summed across the batch. A recipe’s output quantity does not multiply its XP. With 100 wisdom, the 20-material example grants 683 XP per craft.

Level Penalty (level_penalty):

• Up to 10 levels above the recipe → 1.0 (no additional penalty)
• More than 10 levels above item → 0 (0 XP)

Wisdom Bonus (wisdom_bonus):

• Formula: (1 + wisdom × 0.001)
• Each wisdom point = +0.1% XP

Gathering and Crafting Effect Keywords

Equipment uses separate effect codes for gathering and crafting cooldowns:

Skill	Gathering effect	Crafting effect
Mining	mining_gathering	mining_crafting
Woodcutting	woodcutting_gathering	woodcutting_crafting
Fishing	fishing_gathering	—
Alchemy	alchemy_gathering	alchemy_crafting
Weaponcrafting	—	weaponcrafting_crafting
Gearcrafting	—	gearcrafting_crafting
Jewelrycrafting	—	jewelrycrafting_crafting
Cooking	—	cooking_crafting

A value of -20 means a 20% cooldown reduction. Bonuses for the same skill and action add together. Gathering bonuses only affect gathering; crafting bonuses only affect crafting. These effects change cooldowns, not XP per action.

For crafting, the combined reduction is capped at 100% and applies to the whole batch before rounding, with a minimum cooldown of 1 second. For example, 10 crafts at the recipe’s level take 50 seconds before bonuses; a -25 crafting effect reduces that to 38 seconds after rounding.

API migration

Bare skill codes such as mining, woodcutting, fishing, and alchemy no longer grant cooldown reductions. Use the action-specific effect codes above. Skill identifiers in recipes, resources, workshops, and character levels stay the same: for example, craft.skill is still alchemy.

Retrieving Craftable Items

To retrieve a paginated list of all items craftable with a specific skill, use the following endpoint:

Endpoint: GET /items?craft_skill={skill}

cURL

curl --request GET \
--url 'https://api.artifactsmmo.com/items?craft_skill=weaponcrafting' \
--header 'Accept: application/json'

JavaScript

const url = 'https://api.artifactsmmo.com/items?craft_skill=weaponcrafting';
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/items"
response = requests.get(url, params={"craft_skill": "weaponcrafting"})
print(response.json())

View the API Reference

Craft Action

To craft an item at a workshop, use the following endpoint. You must have the required skill level and materials in your inventory:

Endpoint: POST /my/{name}/action/crafting

cURL

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

JavaScript

const url = 'https://api.artifactsmmo.com/my/{name}/action/crafting';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
},
body: JSON.stringify({ code: "iron_sword" })
};

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/crafting"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}
data = {"code": "iron_sword"}

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

View the API Reference

Field	Description
code	The item code to craft.
quantity	Number of items to craft (optional, default 1).

Experience to Level

Here’s the table showing the experience required to level up. This table applies to all skills and combat.

Leveling Progression Tiers

Level Range	XP Increase Per Level
1-3	+100
4-8	+250
9-13	+400
14-18	+700
19-23	+1000
24-28	+1200
29-33	+1500
34-39	+1800
40-44	+2100
45+	+1800

Level	XP required to level up
1	150
2	250
3	350
4	450
5	700
6	950
7	1,200
8	1,450
9	1,700
10	2,100
11	2,500
12	2,900
13	3,300
14	3,700
15	4,400
16	5,100
17	5,800
18	6,500
19	7,200
20	8,200
21	9,200
22	10,200
23	11,200
24	12,200
25	13,400
26	14,600
27	15,800
28	17,000
29	18,200
30	19,700
31	21,200
32	22,700
33	24,200
34	25,700
35	27,500
36	29,300
37	31,100
38	32,900
39	34,700
40	36,500
41	38,600
42	40,700
43	42,800
44	44,900
45	47,000
46	48,800
47	50,600
48	52,400
49	54,200
50	— (max level)