API Endpoints

Get item metadata

get

/api/metadata/items/{id}

Retrieve metadata for a specific item by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get item metadata retrieved successfully

application/json

404

item metadata not found

application/json

get

/api/metadata/items/{id}

GET /api/metadata/items/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

{
  "id": "text",
  "name": "text",
  "description": "text",
  "image": "text",
  "attributes": [
    {
      "trait_type": "text",
      "value": "text"
    }
  ]
}

Get tool metadata

get

/api/metadata/tools/{id}

Retrieve metadata for a specific tool by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get tool metadata retrieved successfully

application/json

404

tool metadata not found

application/json

get

/api/metadata/tools/{id}

GET /api/metadata/tools/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

{
  "id": "text",
  "name": "text"
}

Get friend metadata

get

/api/metadata/friends/{id}

Retrieve metadata for a specific friend by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get friend metadata retrieved successfully

application/json

404

friend metadata not found

application/json

get

/api/metadata/friends/{id}

GET /api/metadata/friends/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

{
  "id": "text",
  "name": "text"
}

Get monster metadata

get

/api/metadata/monsters/{id}

Retrieve metadata for a specific monster by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get monster metadata retrieved successfully

application/json

404

monster metadata not found

application/json

get

/api/metadata/monsters/{id}

GET /api/metadata/monsters/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

{
  "id": "text",
  "name": "text"
}

Get character metadata

get

/api/metadata/characters/{id}

Retrieve metadata for a specific character by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get character metadata retrieved successfully

application/json

404

character metadata not found

application/json

get

/api/metadata/characters/{id}

GET /api/metadata/characters/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

{
  "tokenId": 1,
  "name": "text",
  "description": "text",
  "image": "text",
  "attributes": [
    {
      "trait_type": "text",
      "value": "text"
    }
  ]
}

Get apartment metadata

get

/api/metadata/apartments/{id}

Retrieve metadata for a specific apartment by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get apartment metadata retrieved successfully

application/json

404

apartment metadata not found

application/json

get

/api/metadata/apartments/{id}

GET /api/metadata/apartments/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

{
  "id": "text",
  "name": "text"
}

Get animated profile pictures

get

/api/images/characters/animated-pfps

Retrieve animated profile pictures for characters

Responses

200

Get animated profile pictures retrieved successfully

image/*

Responsestring · binary

404

animated profile pictures not found

application/json

get

/api/images/characters/animated-pfps

GET /api/images/characters/animated-pfps HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get static profile pictures

get

/api/images/characters/static-pfps

Retrieve static profile pictures for characters

Responses

200

Get static profile pictures retrieved successfully

image/*

Responsestring · binary

404

static profile pictures not found

application/json

get

/api/images/characters/static-pfps

GET /api/images/characters/static-pfps HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get character overworld atlas

get

/api/images/characters/overworld-atlas

Retrieve overworld atlas for characters

Responses

200

Get character overworld atlas retrieved successfully

image/*

Responsestring · binary

404

character overworld atlas not found

application/json

get

/api/images/characters/overworld-atlas

GET /api/images/characters/overworld-atlas HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get character GIFs

get

/api/images/characters/gifs

Retrieve character GIFs

Responses

200

Get character GIFs retrieved successfully

image/*

Responsestring · binary

404

character GIFs not found

application/json

get

/api/images/characters/gifs

GET /api/images/characters/gifs HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get monster NFT image by ID

get

/api/images/monsters/nfts/{id}

Retrieve image for a specific monster NFT by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get monster NFT image by ID retrieved successfully

image/*

Responsestring · binary

404

monster NFT image by ID not found

application/json

get

/api/images/monsters/nfts/{id}

GET /api/images/monsters/nfts/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get all monster NFT images

get

/api/images/monsters/nfts

Retrieve all monster NFT images

Responses

200

Get all monster NFT images retrieved successfully

image/*

Responsestring · binary

404

all monster NFT images not found

application/json

get

/api/images/monsters/nfts

GET /api/images/monsters/nfts HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get monster NFT image by ID

get

/api/images/monsters/nfts/page/{id}

Retrieve image for a specific monster NFT by ID

Path parameters

idstringRequired

Id ID

Responses

200

Get monster NFT image by ID retrieved successfully

image/*

Responsestring · binary

404

monster NFT image by ID not found

application/json

get

/api/images/monsters/nfts/page/{id}

GET /api/images/monsters/nfts/page/{id} HTTP/1.1
Host: api.spellborne.gg
Accept: */*

binary

Get monster data by ID

get

/api/data/monsters/{id}

Retrieve detailed data for a specific monster by ID

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Path parameters

idstringRequired

Id ID

Responses

200

Get monster data by ID retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

monster data by ID not found

application/json

get

/api/data/monsters/{id}

GET /api/data/monsters/{id} HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "breedName": "text",
  "tokenId": "text",
  "variant": "text",
  "flags": {
    "changesColorWithSeason": true
  },
  "assets": {
    "profilePicture": "text",
    "frontSprite": "text",
    "backSprite": "text"
  },
  "name": "text",
  "level": 1,
  "experience": 1,
  "description": "text",
  "eggGroup": "text",
  "type": {
    "primary": "text",
    "secondary": "text"
  },
  "statistics": {
    "HP": 1,
    "SP": 1,
    "maxHP": 1,
    "maxSP": 1,
    "ATK": 1,
    "sATK": 1,
    "DEF": 1,
    "sDEF": 1,
    "SPE": 1,
    "trust": 1
  },
  "innatePotential": {
    "HP": 1,
    "SP": 1,
    "ATK": 1,
    "DEF": 1,
    "SPE": 1,
    "sATK": 1,
    "sDEF": 1,
    "total": 1
  },
  "visiblePotential": {
    "HP": 1,
    "SP": 1,
    "ATK": 1,
    "DEF": 1,
    "SPE": 1,
    "sATK": 1,
    "sDEF": 1
  },
  "likes": "text",
  "dislikes": "text",
  "ability": "text",
  "movesData": [
    {
      "name": "text",
      "class": "text",
      "type": "text",
      "power": 1,
      "accuracy": 1,
      "cost": 1,
      "description": "text"
    }
  ],
  "personality": "text",
  "originalHunter": "text",
  "gender": "text",
  "itemHeld": "text",
  "cosmeticItem": "text",
  "experienceForNextLevel": 1,
  "captureDetails": {},
  "createdAt": "2026-01-17T20:25:15.176Z",
  "availableMovesData": [
    {
      "name": "text",
      "class": "text",
      "type": "text",
      "power": 1,
      "accuracy": 1,
      "cost": 1,
      "description": "text"
    }
  ],
  "statusEffect": "text",
  "unallocatedPoints": 1,
  "isEgg": true,
  "eggDetails": {},
  "owner": "text"
}

Get user data by wallet address

get

/api/data/users/{address}

Retrieve user data for a specific wallet address

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Path parameters

addressstringRequired

Wallet address or username of the user

Responses

200

Get user data by wallet address retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

user data by wallet address not found

application/json

get

/api/data/users/{address}

GET /api/data/users/{address} HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "address": "text",
  "username": "text",
  "equippedOutfit": "text",
  "lastOnline": "2026-01-17T20:25:15.176Z",
  "accountHealth": 1,
  "currentGuild": "text",
  "squad": [
    "text"
  ],
  "stellarPass": true,
  "battles": {
    "wins": 1,
    "losses": 1,
    "total": 1
  },
  "skills": {
    "training": 1,
    "farming": 1,
    "crafting": 1,
    "breeding": 1,
    "mining": 1,
    "fishing": 1
  }
}

Get user's monster daycare

get

/api/data/users/{address}/daycare

Retrieve paginated list of monsters owned by a user with sorting options

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Path parameters

addressstringRequired

Wallet address or username of the user

Query parameters

pageintegerOptional

Page number

Default: 1

limitintegerOptional

Items per page (max 100)

Default: 20

sortBystring · enumOptional

Sort field (createdAt, experience, or innateBst for total IVs)

Default: createdAtPossible values:

sortOrderstring · enumOptional

Sort order

Default: descPossible values:

Responses

200

Get user's monster daycare retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

user's monster daycare not found

application/json

get

/api/data/users/{address}/daycare

GET /api/data/users/{address}/daycare HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "monsters": [
    {
      "id": "text",
      "breedCode": "text",
      "nickname": "text",
      "level": 1,
      "experience": 1,
      "gender": "text",
      "variant": "text",
      "personality": "text",
      "innatePotential": {
        "HP": 1,
        "SP": 1,
        "ATK": 1,
        "DEF": 1,
        "sATK": 1,
        "sDEF": 1,
        "SPE": 1,
        "total": 1
      },
      "visiblePotential": {
        "HP": 1,
        "SP": 1,
        "ATK": 1,
        "DEF": 1,
        "sATK": 1,
        "sDEF": 1,
        "SPE": 1
      },
      "statistics": {
        "HP": 1,
        "SP": 1
      },
      "itemHeld": "text",
      "cosmeticItem": "text",
      "createdAt": "2026-01-17T20:25:15.176Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrev": true
  },
  "filters": {
    "sortBy": "text",
    "sortOrder": "text"
  }
}

Get guild data by ID

get

/api/data/guilds/{id}

Retrieve detailed data for a specific guild by ID

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Path parameters

idstringRequired

Id ID

Responses

200

Get guild data by ID retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

guild data by ID not found

application/json

get

/api/data/guilds/{id}

GET /api/data/guilds/{id} HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "name": "text",
  "description": "text",
  "apartment": "text",
  "parentGuildId": "text",
  "assets": {
    "logo": "text"
  },
  "experience": 1,
  "chestKeys": 1,
  "createdAt": "2026-01-17T20:25:15.176Z",
  "updatedAt": "2026-01-17T20:25:15.176Z",
  "logs": [
    {}
  ]
}

Get guild members with pagination

get

/api/data/guilds/{id}/members

Retrieve members of a specific guild with pagination support

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Path parameters

idstringRequired

Id ID

Query parameters

pageintegerOptional

Page number for pagination

Default: 1

limitintegerOptional

Number of items per page

Default: 10

Responses

200

Get guild members with pagination retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

guild members with pagination not found

application/json

get

/api/data/guilds/{id}/members

GET /api/data/guilds/{id}/members HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "members": [
    {
      "address": "text",
      "username": "text",
      "role": "text",
      "joinedAt": "2026-01-17T20:25:15.176Z",
      "updatedAt": "2026-01-17T20:25:15.176Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "totalItems": 1,
    "itemsPerPage": 1
  }
}

Get monster marketplace statistics

get

/api/marketplace/monsters/stats/overview

Retrieve monster marketplace overview including total listings, 30-day volume, and recent sales

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Responses

200

Get monster marketplace statistics retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

monster marketplace statistics not found

application/json

get

/api/marketplace/monsters/stats/overview

GET /api/marketplace/monsters/stats/overview HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "totalListings": 1,
  "volume": {
    "last30Days": 1,
    "salesCount": 1,
    "averagePrice": 1
  },
  "recentSales": [
    {
      "monsterId": "text",
      "price": "text",
      "buyer": "text",
      "timestamp": "2026-01-17T20:25:15.176Z"
    }
  ]
}

Get monster listing details

get

/api/marketplace/monsters/{orderId}

Retrieve detailed information about a specific monster listing including metadata, stats, and blockchain data

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Path parameters

orderIdstringRequired

Order ID

Query parameters

chainIdintegerOptional

Blockchain chain ID

Default: 11155111

Responses

200

Get monster listing details retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

monster listing details not found

application/json

get

/api/marketplace/monsters/{orderId}

GET /api/marketplace/monsters/{orderId} HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "orderId": "text",
  "chainId": 1,
  "contract": "text",
  "tokenId": "text",
  "price": {
    "amount": {
      "raw": "text",
      "decimal": 1
    },
    "currency": {
      "contract": "text",
      "symbol": "text",
      "name": "text",
      "decimals": 1
    }
  },
  "owner": "text",
  "createdAt": "2026-01-17T20:25:15.176Z",
  "expiry": "2026-01-17T20:25:15.176Z",
  "quantityRemaining": 1,
  "metadata": {
    "name": "text",
    "description": "text",
    "image": "text",
    "attributes": [
      {}
    ],
    "level": 1,
    "breed": "text",
    "nickname": "text",
    "gender": "text",
    "experience": 1,
    "stats": {
      "hp": 1,
      "sp": 1
    },
    "trust": {},
    "itemHeld": "text",
    "cosmeticItem": "text",
    "personality": "text",
    "innatePotential": {
      "HP": 1,
      "SP": 1,
      "ATK": 1,
      "DEF": 1,
      "sATK": 1,
      "sDEF": 1,
      "SPE": 1,
      "total": 1
    }
  }
}

Browse monster marketplace listings

get

/api/marketplace/monsters

Search and browse monster NFT listings with advanced filtering by breed, stats, IVs, personality, and more

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Query parameters

pageintegerOptional

Page number

Default: 1

pageSizeintegerOptional

Items per page

Default: 20

sortBystringOptional

Sort method

Default: price_asc

chainIdintegerOptional

Filter by blockchain chain ID

minPricenumberOptional

Minimum price filter

maxPricenumberOptional

Maximum price filter

breedCodestringOptional

Filter by monster breed

genderstringOptional

Filter by gender

personalitystringOptional

Filter by personality

variantstringOptional

Filter by color variant

searchstringOptional

Search by nickname or breed name

Responses

200

Browse monster marketplace listings retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

monster marketplace listings not found

application/json

get

/api/marketplace/monsters

GET /api/marketplace/monsters HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "listings": [
    {
      "orderId": "text",
      "chainId": 1,
      "contract": "text",
      "tokenId": "text",
      "price": {
        "amount": {
          "raw": "text",
          "decimal": 1
        },
        "currency": {
          "contract": "text",
          "symbol": "text",
          "name": "text",
          "decimals": 1
        }
      },
      "owner": "text",
      "createdAt": "2026-01-17T20:25:15.176Z",
      "expiry": "2026-01-17T20:25:15.176Z",
      "quantityRemaining": 1,
      "metadata": {
        "name": "text",
        "description": "text",
        "image": "text",
        "attributes": [
          {}
        ],
        "level": 1,
        "breed": "text",
        "nickname": "text",
        "gender": "text",
        "experience": 1,
        "stats": {
          "hp": 1,
          "sp": 1
        },
        "personality": "text",
        "innatePotential": {
          "HP": 1,
          "SP": 1,
          "ATK": 1,
          "DEF": 1,
          "sATK": 1,
          "sDEF": 1,
          "SPE": 1,
          "total": 1
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 1,
    "total": 1,
    "hasMore": true
  },
  "filters": {
    "availableCurrencies": [
      {
        "contract": "text",
        "symbol": "text",
        "name": "text"
      }
    ],
    "priceRange": {
      "min": 1,
      "max": 1
    }
  }
}

Get bazaar sales history

get

/api/bazaar/sales

Retrieve historical sales data with optional time period and item filters

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Query parameters

pageintegerOptional

Page number

Default: 1

limitintegerOptional

Items per page (max 100)

Default: 50

itemCodestringOptional

Filter by item code

commodityTypestring · enumOptional

Filter by commodity type

Possible values:

periodstring · enumOptional

Time period for sales history

Default: 7dPossible values:

minPricenumberOptional

Minimum price filter

maxPricenumberOptional

Maximum price filter

Responses

200

Get bazaar sales history retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

bazaar sales history not found

application/json

get

/api/bazaar/sales

GET /api/bazaar/sales HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "sales": [
    {
      "id": "text",
      "itemCode": "text",
      "itemName": "text",
      "itemDescription": "text",
      "commodityType": "text",
      "amount": 1,
      "price": 1,
      "perItemPrice": 1,
      "currency": "text",
      "chainId": 1,
      "saleDate": "2026-01-17T20:25:15.176Z",
      "txHash": "text"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrev": true
  },
  "summary": {
    "period": "text",
    "totalSales": 1,
    "totalVolume": 1,
    "averagePrice": 1,
    "itemCode": "text",
    "commodityType": "text"
  }
}

Browse bazaar buy offers

get

/api/bazaar/offers

Search and browse active buy offers for items, skins, and tools with pagination and filtering

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Query parameters

pageintegerOptional

Page number

Default: 1

limitintegerOptional

Items per page (max 100)

Default: 50

itemCodestringOptional

Filter by item code

commodityTypestring · enumOptional

Filter by commodity type

Possible values:

minPricenumberOptional

Minimum price filter

maxPricenumberOptional

Maximum price filter

chainIdintegerOptional

Filter by blockchain chain ID

sortBystring · enumOptional

Sort field

Default: createdAtPossible values:

sortOrderstring · enumOptional

Sort order

Default: descPossible values:

Responses

200

Browse bazaar buy offers retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

bazaar buy offers not found

application/json

get

/api/bazaar/offers

GET /api/bazaar/offers HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "offers": [
    {
      "id": "text",
      "itemCode": "text",
      "itemName": "text",
      "itemDescription": "text",
      "commodityType": "ITEM",
      "amount": 1,
      "price": 1,
      "perItemPrice": 1,
      "currency": "text",
      "chainId": 1,
      "createdAt": "2026-01-17T20:25:15.176Z",
      "expiresAt": "2026-01-17T20:25:15.176Z",
      "buyer": {
        "username": "text",
        "equippedOutfit": "text"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrev": true
  },
  "filters": {
    "itemCode": "text",
    "commodityType": "text",
    "chainId": 1,
    "priceRange": {
      "min": 1,
      "max": 1
    },
    "sortBy": "text",
    "sortOrder": "text"
  }
}

Browse bazaar item listings

get

/api/bazaar/listings

Search and browse active marketplace listings for items, skins, and tools with pagination and filtering

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Query parameters

pageintegerOptional

Page number

Default: 1

limitintegerOptional

Items per page (max 100)

Default: 50

itemCodestringOptional

Filter by item code

commodityTypestring · enumOptional

Filter by commodity type

Possible values:

minPricenumberOptional

Minimum price filter

maxPricenumberOptional

Maximum price filter

sortBystring · enumOptional

Sort field

Default: createdAtPossible values:

sortOrderstring · enumOptional

Sort order

Default: descPossible values:

Responses

200

Browse bazaar item listings retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

bazaar item listings not found

application/json

get

/api/bazaar/listings

GET /api/bazaar/listings HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "listings": [
    {
      "id": "text",
      "itemCode": "text",
      "itemName": "text",
      "itemDescription": "text",
      "commodityType": "ITEM",
      "amount": 1,
      "price": 1,
      "perItemPrice": 1,
      "currency": "text",
      "createdAt": "2026-01-17T20:25:15.176Z",
      "expiresAt": "2026-01-17T20:25:15.176Z",
      "seller": {
        "username": "text",
        "equippedOutfit": "text"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrev": true
  },
  "filters": {
    "itemCode": "text",
    "commodityType": "text",
    "priceRange": {
      "min": 1,
      "max": 1
    },
    "sortBy": "text",
    "sortOrder": "text"
  }
}

Get bazaar marketplace statistics

get

/api/bazaar/stats

Retrieve marketplace overview statistics including total trades, volume, active listings/offers, trending items, and price changes

Authorizations

x-api-tokenstringRequired

API token for authentication. Include this token in the x-api-token header for all /api/data/*, /api/bazaar/*, and /api/marketplace/* endpoints.

Example:

curl -H "x-api-token: your-api-token-here" https://api.spellborne.gg/api/data/users/0x123...

Rate Limits:

Authenticated endpoints: 100 requests per 5 minutes per API token
Public endpoints: 100 requests per 5 minutes per IP address

Responses

200

Get bazaar marketplace statistics retrieved successfully

application/json

401

Unauthorized - Invalid or missing API token

application/json

404

bazaar marketplace statistics not found

application/json

get

/api/bazaar/stats

GET /api/bazaar/stats HTTP/1.1
Host: api.spellborne.gg
x-api-token: YOUR_API_KEY
Accept: */*

{
  "overview": {
    "totalTrades": 1,
    "totalVolume": 1,
    "activeListings": 1,
    "activeOffers": 1,
    "lastUpdated": "2026-01-17T20:25:15.176Z"
  },
  "trading": {
    "latestTrades": [
      {
        "price": 1,
        "buyerAddress": "text",
        "itemCode": "text",
        "itemName": "text",
        "itemDescription": "text",
        "commodityType": "text",
        "amount": 1,
        "buyerUsername": "text",
        "buyerEquippedOutfit": "text",
        "isPrivateListing": true
      }
    ],
    "topVolumeItems": [
      {
        "itemCode": "text",
        "itemName": "text",
        "itemDescription": "text",
        "commodityType": "text",
        "volume24h": 1,
        "trades24h": 1,
        "currentFloorPrice": 1
      }
    ]
  },
  "prices": {
    "priceChanges24h": {},
    "priceChanges7d": {}
  },
  "metadata": {
    "supportedChains": [
      "text"
    ],
    "supportedCurrency": "text",
    "dataSource": "text"
  }
}

PreviousAPI Key NextCreators

Last updated 1 month ago

hashtagGet item metadata

hashtagGet tool metadata

hashtagGet friend metadata

hashtagGet monster metadata

hashtagGet character metadata

hashtagGet apartment metadata

hashtagGet animated profile pictures

hashtagGet static profile pictures

hashtagGet character overworld atlas

hashtagGet character GIFs

hashtagGet monster NFT image by ID

hashtagGet all monster NFT images

hashtagGet monster NFT image by ID

hashtagGet monster data by ID

hashtagGet user data by wallet address

hashtagGet user's monster daycare

hashtagGet guild data by ID

hashtagGet guild members with pagination

hashtagGet monster marketplace statistics

hashtagGet monster listing details

hashtagBrowse monster marketplace listings

hashtagGet bazaar sales history

hashtagBrowse bazaar buy offers

hashtagBrowse bazaar item listings

hashtagGet bazaar marketplace statistics

Get item metadata

Get tool metadata

Get friend metadata

Get monster metadata

Get character metadata

Get apartment metadata

Get animated profile pictures

Get static profile pictures

Get character overworld atlas

Get character GIFs

Get monster NFT image by ID

Get all monster NFT images

Get monster NFT image by ID

Get monster data by ID

Get user data by wallet address

Get user's monster daycare

Get guild data by ID

Get guild members with pagination

Get monster marketplace statistics

Get monster listing details

Browse monster marketplace listings

Get bazaar sales history

Browse bazaar buy offers

Browse bazaar item listings

Get bazaar marketplace statistics