> For the complete documentation index, see [llms.txt](https://noctaly-bot.gitbook.io/noctaly-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://noctaly-bot.gitbook.io/noctaly-api/economy/profile.md).

# Profile

#### Get Economy Profile <a href="#get-economy-profile" id="get-economy-profile"></a>

```http
GET guilds/{guildID}/users/{userID}/eco-profile
```

Returns the economy profile of a member. By default only `money` is returned. Pass query parameters to include optional relations.

**Query Parameters**

| Parameter   | Type      | Description                                            |
| ----------- | --------- | ------------------------------------------------------ |
| items       | `boolean` | Set to `true` to include the member's item inventory.  |
| chests      | `boolean` | Set to `true` to include the member's chest inventory. |
| dailyStreak | `boolean` | Set to `true` to include the member's daily streak.    |

**Response Fields**

| Field       | Type                  | Description                                                                                      |
| ----------- | --------------------- | ------------------------------------------------------------------------------------------------ |
| money       | `number`              | The member's current balance.                                                                    |
| items       | `UserItem[]`          | *(Only if `?items=true`)* Items held by the member.                                              |
| chests      | `UserChest[]`         | *(Only if `?chests=true`)* Chests held by the member.                                            |
| dailyStreak | `DailyStreak \| null` | *(Only if `?dailyStreak=true`)* The member's daily streak, or `null` if they have never claimed. |

```json
{
    "money": 12500,
    "items": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "name": "Magic Sword",
            "description": "A legendary blade.",
            "type": "CUSTOM",
            "flags": ["KEEP_AFTER_USE"],
            "emoji": "⚔️",
            "emojiType": "UNICODE",
            "iconURL": null,
            "buyPrice": 1000,
            "sellPrice": 500,
            "quantity": 3,
            "durability": 8,
            "maxDurability": 10
        }
    ],
    "chests": [
        {
            "id": "660e9511-f30c-52e5-b827-557766551111",
            "name": "Golden Chest",
            "primaryColor": "FFD700",
            "secondaryColor": "FFA500",
            "iconURL": null,
            "flags": ["ANIMATED"],
            "buyPrice": 5000,
            "sellPrice": 2500,
            "quantity": 2
        }
    ],
    "dailyStreak": {
        "streak": 7,
        "lastClaim": "2026-03-08T14:32:00.000Z"
    }
}
```

**UserItem**

<table><thead><tr><th width="249">Field</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td><code>string</code></td><td>UUID of the item.</td></tr><tr><td>name</td><td><code>string</code></td><td>Display name.</td></tr><tr><td>description</td><td><code>string | null</code></td><td>Optional description.</td></tr><tr><td>type</td><td><code>string</code></td><td>Item type.</td></tr><tr><td>flags</td><td><code>string[]</code></td><td>Item flags.</td></tr><tr><td>emoji</td><td><code>string | null</code></td><td>Emoji.</td></tr><tr><td>emojiType</td><td><code>string | null</code></td><td><code>"UNICODE"</code> or <code>"CUSTOM"</code>.</td></tr><tr><td>iconURL</td><td><code>string | null</code></td><td>Custom icon URL.</td></tr><tr><td>buyPrice</td><td><code>number</code></td><td>Buy price.</td></tr><tr><td>sellPrice</td><td><code>number</code></td><td>Sell price.</td></tr><tr><td>durability</td><td><code>number | null</code></td><td>Current durability of the active stack.</td></tr><tr><td>maxDurability</td><td><code>number</code></td><td>Full durability per item (<code>0</code> = no durability).</td></tr><tr><td>quantity</td><td><code>number | null</code></td><td>How many the member owns.</td></tr></tbody></table>

**UserChest**

| Field          | Type             | Description               |
| -------------- | ---------------- | ------------------------- |
| id             | `string`         | UUID of the chest.        |
| name           | `string`         | Display name.             |
| primaryColor   | `string`         | Primary hex color.        |
| secondaryColor | `string`         | Secondary hex color.      |
| iconURL        | `string \| null` | Custom icon URL.          |
| flags          | `string[]`       | Chest flags.              |
| buyPrice       | `number`         | Buy price.                |
| sellPrice      | `number`         | Sell price.               |
| quantity       | `number`         | How many the member owns. |

**DailyStreak**

| Field     | Type     | Description                      |
| --------- | -------- | -------------------------------- |
| streak    | `number` | Current streak count.            |
| lastClaim | `string` | ISO 8601 date of the last claim. |