Skip to main content

Lootbox Routes

These endpoints provide access to lootbox data, including details about specific lootboxes and their configurations. Note this essentially is referring to blind box collections created on Crystara.

Get Lootbox Details

Retrieves detailed information about a specific lootbox.

GET /api/lootbox

Parameters

NameRequiredDescription
creatorYesCreator address of the lootbox
collectionYesCollection name of the lootbox

Example Request

fetch('https://api.crystara.trade/mainnet/api/lootbox?creator=0x123abc...&collection=CryptoWarriors', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Lootbox Revenue

Retrieves revenue data for a specific lootbox over a given timeframe.

GET /api/lootbox-revenue

Parameters

NameRequiredDescription
creatorYesCreator address of the lootbox
collectionYesCollection name of the lootbox
timeframeYesTime period for revenue data (e.g., '24h', '7d', '30d', 'all')

Example Request

fetch('https://api.crystara.trade/mainnet/api/lootbox-revenue?creator=0x123abc...&collection=CryptoWarriors&timeframe=7d', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Tokens By Lootbox ID

Retrieves all tokens associated with a specific lootbox ID.

GET /api/tokens-by-lootbox

Parameters

NameRequiredDescription
lootboxIdYesNumeric ID of the lootbox

Example Request

fetch('https://api.crystara.trade/mainnet/api/tokens-by-lootbox?lootboxId=42', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Tokens By Collection

Retrieves tokens from a specific collection with pagination.

GET /api/tokens-by-collection

Parameters

NameRequiredDescription
creatorYesCreator address of the collection
collectionYesCollection name
pageNoPage number (default: 1)
limitNoReturned size (default: 50)

Example Request

fetch('https://api.crystara.trade/mainnet/api/tokens-by-collection?creator=0x123abc...&collection=CryptoWarriors&page=1', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Tokens By Lootbox Creator

Retrieves all tokens created by a specific lootbox creator.

GET /api/tokens-by-lootbox-creator

Parameters

NameRequiredDescription
creatorYesCreator address
collectionYesCollection name

Example Request

fetch('https://api.crystara.trade/mainnet/api/tokens-by-lootbox-creator?creator=0x123abc...&collection=CryptoWarriors', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Token Collection By Lootbox

Retrieves collection information for tokens in a specific lootbox.

GET /api/token-collection-by-lootbox-creator

Parameters

NameRequiredDescription
creatorYesCreator address
collectionYesCollection name

Example Request

fetch('https://api.crystara.trade/mainnet/api/token-collection-by-lootbox-creator?creator=0x123abc...&collection=CryptoWarriors', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Rarities By Lootbox ID

Retrieves rarity information for a specific lootbox.

GET /api/rarities-by-lootbox

Parameters

NameRequiredDescription
lootboxIdYesNumeric ID of the lootbox

Example Request

fetch('https://api.crystara.trade/mainnet/api/rarities-by-lootbox?lootboxId=42', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Rarities By Collection

Retrieves rarity information for all tokens in a collection.

GET /api/rarities-by-collection

Parameters

NameRequiredDescription
creatorYesCreator address
collectionYesCollection name

Example Request

fetch('https://api.crystara.trade/mainnet/api/rarities-by-collection?creator=0x123abc...&collection=CryptoWarriors', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Additional Information

For updates on new endpoints or changes to existing ones, join our Discord community.

If you need specific lootbox data that isn't currently available through these endpoints, please contact [email protected].

Note: These routes were last updated June 2025.