User Routes
These endpoints provide access to user-specific data, including inventory, activity, and trading history.
User Inventory History Data
Returns historical inventory data for a user.
GET /api/user/inventory-history-data
Parameters
| Name | Required | Description |
|---|---|---|
| address | Yes | User wallet address |
| range | No | Time range for data (default: '24h', options: '24h', '7d', '30d', 'all') |
Example Request
fetch('https://api.crystara.trade/mainnet/user/inventory-history-data?address=0x123abc...&range=7d', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));
Response
Coming Soon
Get User Trading Activity
Returns a user's trading activity history.
GET /api/market/user-activity
Parameters
| Name | Required | Description |
|---|---|---|
| address | Yes | User's wallet address |
| page | No | Page number (default: 1) |
| limit | No | Number of results per page (default: 20) |
Example Request
fetch('https://api.crystara.trade/mainnet/market/user-activity?address=0x123abc...&page=1&limit=20', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));
Response
Coming Soon
Get User Listings
Returns a user's active listings.
GET /api/market/user-listings
Parameters
| Name | Required | Description |
|---|---|---|
| address | Yes | User's wallet address |
| page | No | Page number (default: 1) |
| limit | No | Number of results per page (default: 20) |
Example Request
fetch('https://api.crystara.trade/mainnet/market/user-listings?address=0x123abc...&page=1&limit=20', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));
Response
Coming Soon
Get User Bids
Returns a user's active bids.
GET /api/market/user-bids
Parameters
| Name | Required | Description |
|---|---|---|
| address | Yes | User's wallet address |
| page | No | Page number (default: 1) |
| limit | No | Number of results per page (default: 20) |
Example Request
fetch('https://api.crystara.trade/mainnet/market/user-bids?address=0x123abc...&page=1&limit=20', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));
Response
Coming Soon
Get User Purchase History
Returns a user's purchase history.
GET /api/market/user-history
Parameters
| Name | Required | Description |
|---|---|---|
| address | Yes | User's wallet address |
| page | No | Page number (default: 1) |
| limit | No | Number of results per page (default: 20) |
Example Request
fetch('https://api.crystara.trade/mainnet/market/user-history?address=0x123abc...&page=1&limit=20', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));
Response
Coming Soon
Get Token Balances
Returns token balances for a specific user with filtering options.
GET /api/token-balances
Parameters
| Name | Required | Description |
|---|---|---|
| address | No | Filter by wallet address |
| greaterThanZeroBalance | No | If true, only returns tokens with balance > 0 |
| collection | No | Filter by collection name |
| creator | No | Filter by creator address |
| crystaraInfo | No | If true, includes additional Crystara-specific information |
Example Request
fetch('https://api.crystara.trade/mainnet/token-balances?address=0x123abc...&greaterThanZeroBalance=true&crystaraInfo=true', {
headers: {
'x-api-key': 'your-api-key-here'
}
})
.then(response => response.json())
.then(data => console.log(data));
Response
Coming Soon
Note: These routes were last updated June 2025.