# API Endpoints

## Get item metadata

> Retrieve metadata for a specific item by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/metadata/items/{id}":{"get":{"summary":"Get item metadata","description":"Retrieve metadata for a specific item by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get item metadata retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"image":{"type":"string"},"attributes":{"type":"array","items":{"type":"object","properties":{"trait_type":{"type":"string"},"value":{"type":"string"}}}}}}}}},"404":{"description":"item metadata not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get tool metadata

> Retrieve metadata for a specific tool by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/metadata/tools/{id}":{"get":{"summary":"Get tool metadata","description":"Retrieve metadata for a specific tool by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get tool metadata retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}}}},"404":{"description":"tool metadata not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get friend metadata

> Retrieve metadata for a specific friend by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/metadata/friends/{id}":{"get":{"summary":"Get friend metadata","description":"Retrieve metadata for a specific friend by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get friend metadata retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}}}},"404":{"description":"friend metadata not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get monster metadata

> Retrieve metadata for a specific monster by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/metadata/monsters/{id}":{"get":{"summary":"Get monster metadata","description":"Retrieve metadata for a specific monster by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get monster metadata retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}}}},"404":{"description":"monster metadata not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get character metadata

> Retrieve metadata for a specific character by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/metadata/characters/{id}":{"get":{"summary":"Get character metadata","description":"Retrieve metadata for a specific character by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get character metadata retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"tokenId":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"image":{"type":"string"},"attributes":{"type":"array","items":{"type":"object","properties":{"trait_type":{"type":"string"},"value":{"type":"string"}}}}}}}}},"404":{"description":"character metadata not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get apartment metadata

> Retrieve metadata for a specific apartment by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/metadata/apartments/{id}":{"get":{"summary":"Get apartment metadata","description":"Retrieve metadata for a specific apartment by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get apartment metadata retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}}}},"404":{"description":"apartment metadata not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get animated profile pictures

> Retrieve animated profile pictures for characters

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/characters/animated-pfps":{"get":{"summary":"Get animated profile pictures","description":"Retrieve animated profile pictures for characters","parameters":[],"responses":{"200":{"description":"Get animated profile pictures retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"animated profile pictures not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get static profile pictures

> Retrieve static profile pictures for characters

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/characters/static-pfps":{"get":{"summary":"Get static profile pictures","description":"Retrieve static profile pictures for characters","parameters":[],"responses":{"200":{"description":"Get static profile pictures retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"static profile pictures not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get character overworld atlas

> Retrieve overworld atlas for characters

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/characters/overworld-atlas":{"get":{"summary":"Get character overworld atlas","description":"Retrieve overworld atlas for characters","parameters":[],"responses":{"200":{"description":"Get character overworld atlas retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"character overworld atlas not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get character GIFs

> Retrieve character GIFs

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/characters/gifs":{"get":{"summary":"Get character GIFs","description":"Retrieve character GIFs","parameters":[],"responses":{"200":{"description":"Get character GIFs retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"character GIFs not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get monster NFT image by ID

> Retrieve image for a specific monster NFT by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/monsters/nfts/{id}":{"get":{"summary":"Get monster NFT image by ID","description":"Retrieve image for a specific monster NFT by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get monster NFT image by ID retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"monster NFT image by ID not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get all monster NFT images

> Retrieve all monster NFT images

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/monsters/nfts":{"get":{"summary":"Get all monster NFT images","description":"Retrieve all monster NFT images","parameters":[],"responses":{"200":{"description":"Get all monster NFT images retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"all monster NFT images not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get monster NFT image by ID

> Retrieve image for a specific monster NFT by ID

```json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"paths":{"/api/images/monsters/nfts/page/{id}":{"get":{"summary":"Get monster NFT image by ID","description":"Retrieve image for a specific monster NFT by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get monster NFT image by ID retrieved successfully","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"monster NFT image by ID not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Get monster data by ID

> Retrieve detailed data for a specific monster by ID

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/data/monsters/{id}":{"get":{"summary":"Get monster data by ID","description":"Retrieve detailed data for a specific monster by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get monster data by ID retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"breedName":{"type":"string"},"tokenId":{"type":"string"},"variant":{"type":"string"},"flags":{"type":"object","properties":{"changesColorWithSeason":{"type":"boolean"}}},"assets":{"type":"object","properties":{"profilePicture":{"type":"string"},"frontSprite":{"type":"string"},"backSprite":{"type":"string"}}},"name":{"type":"string"},"level":{"type":"integer"},"experience":{"type":"integer"},"description":{"type":"string"},"eggGroup":{"type":"string"},"type":{"type":"object","properties":{"primary":{"type":"string"},"secondary":{"type":"string"}}},"statistics":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"maxHP":{"type":"integer"},"maxSP":{"type":"integer"},"ATK":{"type":"integer"},"sATK":{"type":"integer"},"DEF":{"type":"integer"},"sDEF":{"type":"integer"},"SPE":{"type":"integer"},"trust":{"type":"integer"}}},"innatePotential":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"ATK":{"type":"integer"},"DEF":{"type":"integer"},"SPE":{"type":"integer"},"sATK":{"type":"integer"},"sDEF":{"type":"integer"},"total":{"type":"integer"}}},"visiblePotential":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"ATK":{"type":"integer"},"DEF":{"type":"integer"},"SPE":{"type":"integer"},"sATK":{"type":"integer"},"sDEF":{"type":"integer"}}},"likes":{"type":"string"},"dislikes":{"type":"string"},"ability":{"type":"string"},"movesData":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"class":{"type":"string"},"type":{"type":"string"},"power":{"type":"integer"},"accuracy":{"type":"integer"},"cost":{"type":"integer"},"description":{"type":"string"}}}},"personality":{"type":"string"},"originalHunter":{"type":"string"},"gender":{"type":"string"},"itemHeld":{"type":"string"},"cosmeticItem":{"type":"string"},"experienceForNextLevel":{"type":"integer"},"captureDetails":{"type":"object"},"createdAt":{"type":"string","format":"date-time"},"availableMovesData":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"class":{"type":"string"},"type":{"type":"string"},"power":{"type":"integer"},"accuracy":{"type":"integer"},"cost":{"type":"integer"},"description":{"type":"string"}}}},"statusEffect":{"type":"string"},"unallocatedPoints":{"type":"integer"},"isEgg":{"type":"boolean"},"eggDetails":{"type":"object"},"owner":{"type":"string"}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"monster data by ID not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get user data by wallet address

> Retrieve user data for a specific wallet address

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/data/users/{address}":{"get":{"summary":"Get user data by wallet address","description":"Retrieve user data for a specific wallet address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Wallet address or username of the user"}],"responses":{"200":{"description":"Get user data by wallet address retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"username":{"type":"string"},"equippedOutfit":{"type":"string"},"lastOnline":{"type":"string","format":"date-time"},"accountHealth":{"type":"number"},"currentGuild":{"type":"string"},"squad":{"type":"array","items":{"type":"string"},"description":"User's squad IDs (only included if data sharing is enabled)"},"stellarPass":{"type":"boolean"},"battles":{"type":"object","properties":{"wins":{"type":"integer"},"losses":{"type":"integer"},"total":{"type":"integer"}}},"skills":{"type":"object","properties":{"training":{"type":"integer"},"farming":{"type":"integer"},"crafting":{"type":"integer"},"breeding":{"type":"integer"},"mining":{"type":"integer"},"fishing":{"type":"integer"}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"user data by wallet address not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get user's monster daycare

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/data/users/{address}/daycare":{"get":{"summary":"Get user's monster daycare","description":"Retrieve paginated list of monsters owned by a user with sorting options","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Wallet address or username of the user"},{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","default":20},"description":"Items per page (max 100)"},{"name":"sortBy","in":"query","schema":{"type":"string","enum":["createdAt","experience","innateBst"],"default":"createdAt"},"description":"Sort field (createdAt, experience, or innateBst for total IVs)"},{"name":"sortOrder","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"description":"Sort order"}],"responses":{"200":{"description":"Get user's monster daycare retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"monsters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"breedCode":{"type":"string"},"nickname":{"type":"string"},"level":{"type":"integer","description":"Calculated from experience"},"experience":{"type":"integer"},"gender":{"type":"string"},"variant":{"type":"string"},"personality":{"type":"string"},"innatePotential":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"ATK":{"type":"integer"},"DEF":{"type":"integer"},"sATK":{"type":"integer"},"sDEF":{"type":"integer"},"SPE":{"type":"integer"},"total":{"type":"integer"}}},"visiblePotential":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"ATK":{"type":"integer"},"DEF":{"type":"integer"},"sATK":{"type":"integer"},"sDEF":{"type":"integer"},"SPE":{"type":"integer"}}},"statistics":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"}}},"itemHeld":{"type":"string"},"cosmeticItem":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"},"hasNext":{"type":"boolean"},"hasPrev":{"type":"boolean"}}},"filters":{"type":"object","properties":{"sortBy":{"type":"string"},"sortOrder":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"user's monster daycare not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get guild data by ID

> Retrieve detailed data for a specific guild by ID

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/data/guilds/{id}":{"get":{"summary":"Get guild data by ID","description":"Retrieve detailed data for a specific guild by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"}],"responses":{"200":{"description":"Get guild data by ID retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"apartment":{"type":"string"},"parentGuildId":{"type":"string"},"assets":{"type":"object","properties":{"logo":{"type":"string"}}},"experience":{"type":"integer"},"chestKeys":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"logs":{"type":"array","items":{"type":"object"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"guild data by ID not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get guild members with pagination

> Retrieve members of a specific guild with pagination support

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/data/guilds/{id}/members":{"get":{"summary":"Get guild members with pagination","description":"Retrieve members of a specific guild with pagination support","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Id ID"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number for pagination"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Number of items per page"}],"responses":{"200":{"description":"Get guild members with pagination retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"username":{"type":"string"},"role":{"type":"string"},"joinedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}},"pagination":{"type":"object","properties":{"currentPage":{"type":"integer"},"totalPages":{"type":"integer"},"totalItems":{"type":"integer"},"itemsPerPage":{"type":"integer"}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"guild members with pagination not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get monster marketplace statistics

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/marketplace/monsters/stats/overview":{"get":{"summary":"Get monster marketplace statistics","description":"Retrieve monster marketplace overview including total listings, 30-day volume, and recent sales","parameters":[],"responses":{"200":{"description":"Get monster marketplace statistics retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"totalListings":{"type":"integer"},"volume":{"type":"object","properties":{"last30Days":{"type":"number"},"salesCount":{"type":"integer"},"averagePrice":{"type":"number"}}},"recentSales":{"type":"array","items":{"type":"object","properties":{"monsterId":{"type":"string"},"price":{"type":"string"},"buyer":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"monster marketplace statistics not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get monster listing details

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/marketplace/monsters/{orderId}":{"get":{"summary":"Get monster listing details","description":"Retrieve detailed information about a specific monster listing including metadata, stats, and blockchain data","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"},"description":"Order ID"},{"name":"chainId","in":"query","schema":{"type":"integer","default":11155111},"description":"Blockchain chain ID"}],"responses":{"200":{"description":"Get monster listing details retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"orderId":{"type":"string"},"chainId":{"type":"integer"},"contract":{"type":"string"},"tokenId":{"type":"string"},"price":{"type":"object","properties":{"amount":{"type":"object","properties":{"raw":{"type":"string"},"decimal":{"type":"number"}}},"currency":{"type":"object","properties":{"contract":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"integer"}}}}},"owner":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"expiry":{"type":"string","format":"date-time"},"quantityRemaining":{"type":"integer"},"metadata":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"image":{"type":"string"},"attributes":{"type":"array","items":{"type":"object"}},"level":{"type":"integer"},"breed":{"type":"string"},"nickname":{"type":"string"},"gender":{"type":"string"},"experience":{"type":"integer"},"stats":{"type":"object","properties":{"hp":{"type":"integer"},"sp":{"type":"integer"}}},"trust":{"type":"object"},"itemHeld":{"type":"string"},"cosmeticItem":{"type":"string"},"personality":{"type":"string"},"innatePotential":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"ATK":{"type":"integer"},"DEF":{"type":"integer"},"sATK":{"type":"integer"},"sDEF":{"type":"integer"},"SPE":{"type":"integer"},"total":{"type":"integer"}}}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"monster listing details not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Browse monster marketplace listings

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/marketplace/monsters":{"get":{"summary":"Browse monster marketplace listings","description":"Search and browse monster NFT listings with advanced filtering by breed, stats, IVs, personality, and more","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"pageSize","in":"query","schema":{"type":"integer","default":20},"description":"Items per page"},{"name":"sortBy","in":"query","schema":{"type":"string","default":"price_asc"},"description":"Sort method"},{"name":"chainId","in":"query","schema":{"type":"integer"},"description":"Filter by blockchain chain ID"},{"name":"minPrice","in":"query","schema":{"type":"number"},"description":"Minimum price filter"},{"name":"maxPrice","in":"query","schema":{"type":"number"},"description":"Maximum price filter"},{"name":"breedCode","in":"query","schema":{"type":"string"},"description":"Filter by monster breed"},{"name":"gender","in":"query","schema":{"type":"string"},"description":"Filter by gender"},{"name":"personality","in":"query","schema":{"type":"string"},"description":"Filter by personality"},{"name":"variant","in":"query","schema":{"type":"string"},"description":"Filter by color variant"},{"name":"search","in":"query","schema":{"type":"string"},"description":"Search by nickname or breed name"}],"responses":{"200":{"description":"Browse monster marketplace listings retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"listings":{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string"},"chainId":{"type":"integer"},"contract":{"type":"string"},"tokenId":{"type":"string"},"price":{"type":"object","properties":{"amount":{"type":"object","properties":{"raw":{"type":"string"},"decimal":{"type":"number"}}},"currency":{"type":"object","properties":{"contract":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"integer"}}}}},"owner":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"expiry":{"type":"string","format":"date-time"},"quantityRemaining":{"type":"integer"},"metadata":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"image":{"type":"string"},"attributes":{"type":"array","items":{"type":"object"}},"level":{"type":"integer"},"breed":{"type":"string"},"nickname":{"type":"string"},"gender":{"type":"string"},"experience":{"type":"integer"},"stats":{"type":"object","properties":{"hp":{"type":"integer"},"sp":{"type":"integer"}}},"personality":{"type":"string"},"innatePotential":{"type":"object","properties":{"HP":{"type":"integer"},"SP":{"type":"integer"},"ATK":{"type":"integer"},"DEF":{"type":"integer"},"sATK":{"type":"integer"},"sDEF":{"type":"integer"},"SPE":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"},"hasMore":{"type":"boolean"}}},"filters":{"type":"object","properties":{"availableCurrencies":{"type":"array","items":{"type":"object","properties":{"contract":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"}}}},"priceRange":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"}}}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"monster marketplace listings not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get bazaar sales history

> Retrieve historical sales data with optional time period and item filters

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/bazaar/sales":{"get":{"summary":"Get bazaar sales history","description":"Retrieve historical sales data with optional time period and item filters","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Items per page (max 100)"},{"name":"itemCode","in":"query","schema":{"type":"string"},"description":"Filter by item code"},{"name":"commodityType","in":"query","schema":{"type":"string","enum":["ITEM","SKIN","TOOL"]},"description":"Filter by commodity type"},{"name":"period","in":"query","schema":{"type":"string","enum":["24h","7d","30d","all"],"default":"7d"},"description":"Time period for sales history"},{"name":"minPrice","in":"query","schema":{"type":"number"},"description":"Minimum price filter"},{"name":"maxPrice","in":"query","schema":{"type":"number"},"description":"Maximum price filter"}],"responses":{"200":{"description":"Get bazaar sales history retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"sales":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"itemCode":{"type":"string"},"itemName":{"type":"string"},"itemDescription":{"type":"string"},"commodityType":{"type":"string"},"amount":{"type":"integer"},"price":{"type":"number"},"perItemPrice":{"type":"number"},"currency":{"type":"string"},"chainId":{"type":"integer"},"saleDate":{"type":"string","format":"date-time"},"txHash":{"type":"string"}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"},"hasNext":{"type":"boolean"},"hasPrev":{"type":"boolean"}}},"summary":{"type":"object","properties":{"period":{"type":"string"},"totalSales":{"type":"integer"},"totalVolume":{"type":"number"},"averagePrice":{"type":"number"},"itemCode":{"type":"string","nullable":true},"commodityType":{"type":"string","nullable":true}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"bazaar sales history not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Browse bazaar buy offers

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/bazaar/offers":{"get":{"summary":"Browse bazaar buy offers","description":"Search and browse active buy offers for items, skins, and tools with pagination and filtering","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Items per page (max 100)"},{"name":"itemCode","in":"query","schema":{"type":"string"},"description":"Filter by item code"},{"name":"commodityType","in":"query","schema":{"type":"string","enum":["ITEM","SKIN","TOOL"]},"description":"Filter by commodity type"},{"name":"minPrice","in":"query","schema":{"type":"number"},"description":"Minimum price filter"},{"name":"maxPrice","in":"query","schema":{"type":"number"},"description":"Maximum price filter"},{"name":"chainId","in":"query","schema":{"type":"integer"},"description":"Filter by blockchain chain ID"},{"name":"sortBy","in":"query","schema":{"type":"string","enum":["createdAt","price","perItemPrice","amount","expiresAt"],"default":"createdAt"},"description":"Sort field"},{"name":"sortOrder","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"description":"Sort order"}],"responses":{"200":{"description":"Browse bazaar buy offers retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"itemCode":{"type":"string"},"itemName":{"type":"string"},"itemDescription":{"type":"string"},"commodityType":{"type":"string","enum":["ITEM","SKIN","TOOL"]},"amount":{"type":"integer"},"price":{"type":"number"},"perItemPrice":{"type":"number"},"currency":{"type":"string"},"chainId":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"buyer":{"type":"object","properties":{"username":{"type":"string"},"equippedOutfit":{"type":"string"}}}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"},"hasNext":{"type":"boolean"},"hasPrev":{"type":"boolean"}}},"filters":{"type":"object","properties":{"itemCode":{"type":"string","nullable":true},"commodityType":{"type":"string","nullable":true},"chainId":{"type":"integer","nullable":true},"priceRange":{"type":"object","properties":{"min":{"type":"number","nullable":true},"max":{"type":"number","nullable":true}}},"sortBy":{"type":"string"},"sortOrder":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"bazaar buy offers not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Browse bazaar item listings

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/bazaar/listings":{"get":{"summary":"Browse bazaar item listings","description":"Search and browse active marketplace listings for items, skins, and tools with pagination and filtering","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Items per page (max 100)"},{"name":"itemCode","in":"query","schema":{"type":"string"},"description":"Filter by item code"},{"name":"commodityType","in":"query","schema":{"type":"string","enum":["ITEM","SKIN","TOOL"]},"description":"Filter by commodity type"},{"name":"minPrice","in":"query","schema":{"type":"number"},"description":"Minimum price filter"},{"name":"maxPrice","in":"query","schema":{"type":"number"},"description":"Maximum price filter"},{"name":"sortBy","in":"query","schema":{"type":"string","enum":["createdAt","price","perItemPrice","amount","expiresAt"],"default":"createdAt"},"description":"Sort field"},{"name":"sortOrder","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"description":"Sort order"}],"responses":{"200":{"description":"Browse bazaar item listings retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"listings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"itemCode":{"type":"string"},"itemName":{"type":"string"},"itemDescription":{"type":"string"},"commodityType":{"type":"string","enum":["ITEM","SKIN","TOOL"]},"amount":{"type":"integer"},"price":{"type":"number"},"perItemPrice":{"type":"number"},"currency":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"seller":{"type":"object","properties":{"username":{"type":"string"},"equippedOutfit":{"type":"string"}}}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"},"hasNext":{"type":"boolean"},"hasPrev":{"type":"boolean"}}},"filters":{"type":"object","properties":{"itemCode":{"type":"string","nullable":true},"commodityType":{"type":"string","nullable":true},"priceRange":{"type":"object","properties":{"min":{"type":"number","nullable":true},"max":{"type":"number","nullable":true}}},"sortBy":{"type":"string"},"sortOrder":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"bazaar item listings not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````

## Get bazaar marketplace statistics

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

````json
{"openapi":"3.0.0","info":{"title":"Spellborne API","version":"1.0.0"},"servers":[{"url":"https://api.spellborne.gg","description":"Production API URL"},{"url":"http://localhost:4000","description":"Local development server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-token","description":"API token for authentication. Include this token in the `x-api-token` header for all `/api/data/*`, `/api/bazaar/*`, and `/api/marketplace/*` endpoints.\n\nExample:\n```\ncurl -H \"x-api-token: your-api-token-here\" https://api.spellborne.gg/api/data/users/0x123...\n```\n\nRate Limits:\n- Authenticated endpoints: 100 requests per 5 minutes per API token\n- Public endpoints: 100 requests per 5 minutes per IP address"}}},"paths":{"/api/bazaar/stats":{"get":{"summary":"Get bazaar marketplace statistics","description":"Retrieve marketplace overview statistics including total trades, volume, active listings/offers, trending items, and price changes","parameters":[],"responses":{"200":{"description":"Get bazaar marketplace statistics retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"overview":{"type":"object","properties":{"totalTrades":{"type":"integer"},"totalVolume":{"type":"number"},"activeListings":{"type":"integer"},"activeOffers":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"}}},"trading":{"type":"object","properties":{"latestTrades":{"type":"array","items":{"type":"object","properties":{"price":{"type":"number"},"buyerAddress":{"type":"string"},"itemCode":{"type":"string"},"itemName":{"type":"string"},"itemDescription":{"type":"string"},"commodityType":{"type":"string"},"amount":{"type":"integer"},"buyerUsername":{"type":"string"},"buyerEquippedOutfit":{"type":"string"},"isPrivateListing":{"type":"boolean"}}}},"topVolumeItems":{"type":"array","items":{"type":"object","properties":{"itemCode":{"type":"string"},"itemName":{"type":"string"},"itemDescription":{"type":"string"},"commodityType":{"type":"string"},"volume24h":{"type":"number"},"trades24h":{"type":"integer"},"currentFloorPrice":{"type":"number"}}}}}},"prices":{"type":"object","properties":{"priceChanges24h":{"type":"object"},"priceChanges7d":{"type":"object"}}},"metadata":{"type":"object","properties":{"supportedChains":{"type":"array","items":{"type":"string"}},"supportedCurrency":{"type":"string"},"dataSource":{"type":"string"}}}}}}}},"401":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"bazaar marketplace statistics not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://whitepaper.spellborne.gg/community/openapi/api-endpoints.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.