### Install GiftAsset SDK

Source: https://github.com/killmode696/giftasset/blob/main/python_sdk/README.md

Install the SDK using pip. This command is used to add the library to your Python environment.

```bash
pip install giftassetsdk
```

--------------------------------

### Example Revenue Split Calculation

Source: https://github.com/killmode696/giftasset/blob/main/starswap/docs/RevenueSplit.md

An example demonstrating the revenue split calculation with specific input values for transaction volume, platform fee rate, partner share, and referral rate.

```plaintext
fee_total = 1000 * 0.05 = $50.00
partner_gross = 50 * 0.30 = $15.00
referral = 15 * 0.10 = $1.50
partner_net = 15 - 1.50 = $13.50
platform_net = 50 - 15 = $35.00
```

--------------------------------

### Get the top deals of the day

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the top deals of the day.

```APIDOC
## GET /providers/deals/top

### Description
Retrieves the top deals of the day.

### Method
GET

### Endpoint
/providers/deals/top
```

--------------------------------

### Get attributes metadata

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves metadata for attributes.

```APIDOC
## GET /metadata/attributes

### Description
Retrieves metadata for attributes.

### Method
GET

### Endpoint
/metadata/attributes
```

--------------------------------

### Get collection buy offers

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves buy offers for a specific collection.

```APIDOC
## GET /providers/collection/buyoffers

### Description
Retrieves buy offers for a specific collection.

### Method
GET

### Endpoint
/providers/collection/buyoffers
```

--------------------------------

### Response for Receiving All User Collections

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

This is an example response from the `/api/v1/gifts/get_all_collections_by_user` endpoint, listing collections owned by a user and the count of each.

```json
[
  {
    "collection_name": "Astral Shard",
    "count": 1
  },
  {
    "collection_name": "Sakura Flower",
    "count": 1
  },
  {
    "collection_name": "Big Year",
    "count": 1
  },
  {
    "collection_name": "Top Hat",
    "count": 1
  },
  {
    "collection_name": "Desk Calendar",
    "count": 1
  },
  {
    "collection_name": "Lunar Snake",
    "count": 1
  },
  {
    "collection_name": "Candy Cane",
    "count": 1
  },
  {
    "collection_name": "Swag Bag",
    "count": 1
  },
  {
    "collection_name": "Snoop Dogg",
    "count": 1
  }
]
```

--------------------------------

### Get collections metadata

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves metadata for collections.

```APIDOC
## GET /metadata/collections

### Description
Retrieves metadata for collections.

### Method
GET

### Endpoint
/metadata/collections
```

--------------------------------

### Get gift prices

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves current pricing information for gifts.

```APIDOC
## GET /analytics/gifts/prices

### Description
Retrieves current pricing information for gifts.

### Method
GET

### Endpoint
/analytics/gifts/prices
```

--------------------------------

### Get providers' sales volumes

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the sales volumes for all providers.

```APIDOC
## GET /providers/sales/volumes

### Description
Retrieves the sales volumes for all providers.

### Method
GET

### Endpoint
/providers/sales/volumes
```

--------------------------------

### Initialize and Use GiftAsset SDK

Source: https://github.com/killmode696/giftasset/blob/main/python_sdk/README.md

Initialize the SDK with an API key and make an asynchronous call to get gift update statistics. Ensure you have an event loop running for async operations.

```python
from giftasset_sdk.giftasset_sdk import SDK
import asyncio

client = SDK(api_key='')

async def main():

  r = await client.get_gifts_update_stat()
  print(r)

asyncio.run(main())
```

--------------------------------

### Get the marketcap of gifts

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the market capitalization data for gifts.

```APIDOC
## GET /analytics/gifts/marketcap

### Description
Retrieves the market capitalization data for gifts.

### Method
GET

### Endpoint
/analytics/gifts/marketcap
```

--------------------------------

### Get the unique deals of the providers

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the unique deals made by providers.

```APIDOC
## GET /providers/deals/unique

### Description
Retrieves the unique deals made by providers.

### Method
GET

### Endpoint
/providers/deals/unique
```

--------------------------------

### Get gift prices

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the current floor prices for gift collections across different marketplaces.

```APIDOC
## GET /api/v1/gifts/get_gifts_price_list

### Description
Retrieves the current floor prices for gift collections.

### Method
GET

### Endpoint
/api/v1/gifts/get_gifts_price_list

### Response
#### Success Response (200)
- **collection_floors** (object) - An object containing floor prices for each collection.
  - **getgems** (number) - The floor price on Getgems.
  - **last_update** (string) - The timestamp of the last price update.
  - **portals** (number) - The floor price on Portals.
  - **tonnel** (number) - The floor price on Tonnel.
```

--------------------------------

### Get Fee Per Provider

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the fee associated with each provider.

```APIDOC
## GET /api/v1/gifts/get_providers_fee

### Description
Get fee per provider.

### Method
GET

### Endpoint
/api/v1/gifts/get_providers_fee

### Response
#### Success Response (200)
- **fee** (integer) - The fee percentage.
- **provider** (string) - The name of the provider.

### Response Example
```json
[
  {
    "fee": 5,
    "provider": "portals"
  },
  {
    "fee": 3,
    "provider": "tonnel"
  },
  {
    "fee": 0,
    "provider": "getgems"
  }
]
```
```

--------------------------------

### Get Collection Buy Offers

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieve buy offers for a specified collection. Requires the collection name in the request body. The response lists offers with their price and count.

```json
{
  "collection_name": "Evil Eye"
}
```

```json
{
  "portals": [
    {
      "collection_name": "Evil Eye",
      "offer_price": 3.12,
      "offers_count": 2
    },
    {
      "collection_name": "Evil Eye",
      "offer_price": 3.11,
      "offers_count": 2
    }
  ]
}
```

--------------------------------

### Get the cost of a user's profile

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the cost associated with a user's profile.

```APIDOC
## GET /user-data/profile/cost

### Description
Retrieves the cost associated with a user's profile.

### Method
GET

### Endpoint
/user-data/profile/cost
```

--------------------------------

### Get Top Deals of the Day

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves a list of the top best deals available for gifts. This endpoint is useful for showcasing daily promotions or trending items.

```json
{
  "getgems": [
    {
      "gift": {
        "attributes": {
          "BACKDROP": {
            "media": "https://giftasset.pro/api/v1/data/backdrops/strawberry.png",
            "name": "Strawberry",
            "rarity": 20,
            "readable_rarity": 2
          },
          "MODEL": {
            "media": "https://giftasset.pro/api/v1/data/models/sketchy.png",
            "name": "Sketchy",
            "rarity": 20,
            "readable_rarity": 2
          },
          "SYMBOL": {
            "media": "https://giftasset.pro/api/v1/data/symbols/boat.png",
            "name": "Boat",
            "rarity": 5,
            "readable_rarity": 0.5
          }
        },
        "attributes_array": [
          {
            "name": "Boat",
            "rarity": 0.5,
            "type": "SYMBOL"
          },
          {
            "name": "Sketchy",
            "rarity": 2,
            "type": "MODEL"
          },
          {
            "name": "Strawberry",
            "rarity": 2,
            "type": "BACKDROP"
          }
        ],
        "collectible_id": 239,
        "id": 811671,
        "last_updated_at": "2025-08-16T07:09:00Z",
        "market_floor": {
          "avg": 3298.667,
          "max": 3688,
          "min": 3079
        },
        "media": {
          "lottie_anim": "https://nft.fragment.com/gift/plushpepe-239.lottie.json",
          "pics": {
            "large": "https://nft.fragment.com/gift/plushpepe-239.large.jpg",
            "medium": "https://nft.fragment.com/gift/plushpepe-239.medium.jpg",
            "small": "https://nft.fragment.com/gift/plushpepe-239.small.jpg"
          }
        },
        "media_preview": "https://nft.fragment.com/gift/plushpepe-239.medium.jpg",
        "providers": {
          "getgems": {
            "collection_floor": 3079,
            "model_floor": null,
            "sales_stat": {
              "sales_24h": 3,
              "sales_24h_value": 9590,
              "sales_all": 53,
              "sales_all_value": 200911
            }
          },
          "portals": {
            "collection_floor": 3129,
            "model_floor": 4399,
            "sales_stat": {
              "sales_24h": 3,
              "sales_24h_value": 11760,
              "sales_all": 411,
              "sales_all_value": 1613905
            }
          },
          "tonnel": {
            "collection_floor": 3688,
            "model_floor": 4000,
            "sales_stat": {
              "sales_24h": 0,
              "sales_24h_value": 0,
              "sales_all": 541,
              "sales_all_value": 906893
            }
          }
        },
        "rarity_index": 0.0002,
        "telegram_gift_id": 6028603284225263000,
        "telegram_gift_name": "PlushPepe-239",
        "telegram_gift_number": 2822,
        "telegram_gift_title": "Plush Pepe",
        "telegram_nft_url": "https://t.me/nft/PlushPepe-239",
        "total_amount": 2861
      },
      "price": 3600,
      "provider": "getgems",
      "type": "deal",
      "unix": 1755351027
    }
  ]
}
```

--------------------------------

### Response for Receiving Gift by Name

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

This JSON object is an example response from the `/api/v1/gifts/get_gift_by_name` endpoint. It provides detailed attributes, market data, and media links for a specific gift.

```json
{
  "attributes": {
    "BACKDROP": {
      "media": "https://giftasset.pro/api/v1/data/backdrops/hunter_green.png",
      "name": "Hunter Green",
      "rarity": 12,
      "readable_rarity": 1.2
    },
    "MODEL": {
      "media": "https://giftasset.pro/api/v1/data/models/redwhelp.png",
      "name": "Red Whelp",
      "rarity": 5,
      "readable_rarity": 0.5
    },
    "SYMBOL": {
      "media": "https://giftasset.pro/api/v1/data/symbols/moose_head.png",
      "name": "Moose Head",
      "rarity": 5,
      "readable_rarity": 0.5
    }
  },
  "attributes_array": [
    {
      "name": "Red Whelp",
      "rarity": 0.5,
      "type": "MODEL"
    },
    {
      "name": "Moose Head",
      "rarity": 0.5,
      "type": "SYMBOL"
    },
    {
      "name": "Hunter Green",
      "rarity": 1.2,
      "type": "BACKDROP"
    }
  ],
  "collectible_id": 1,
  "id": 1707,
  "last_updated_at": "2025-08-16T07:14:44Z",
  "market_floor": {
    "avg": 1.933,
    "max": 2,
    "min": 1.9
  },
  "media": {
    "lottie_anim": "https://nft.fragment.com/gift/easteregg-1.lottie.json",
    "pics": {
      "large": "https://nft.fragment.com/gift/easteregg-1.large.jpg",
      "medium": "https://nft.fragment.com/gift/easteregg-1.medium.jpg",
      "small": "https://nft.fragment.com/gift/easteregg-1.small.jpg"
    }
  },
  "media_preview": "https://nft.fragment.com/gift/easteregg-1.medium.jpg",
  "providers": {
    "getgems": {
      "collection_floor": 1.9,
      "model_floor": 15,
      "sales_stat": {
        "sales_24h": 21,
        "sales_24h_value": 85,
        "sales_all": 251,
        "sales_all_value": 997
      }
    },
    "portals": {
      "collection_floor": 1.9,
      "model_floor": 9.7,
      "sales_stat": {
        "sales_24h": 295,
        "sales_24h_value": 881,
        "sales_all": 18309,
        "sales_all_value": 71787
      }
    },
    "tonnel": {
      "collection_floor": 2,
      "model_floor": 10.2,
      "sales_stat": {
        "sales_24h": 68,
        "sales_24h_value": 218,
        "sales_all": 80013,
        "sales_all_value": 327740
      }
    }
  },
  "rarity_index": 0.00003,
  "telegram_gift_id": 5774079931671643000,
  "telegram_gift_name": "EasterEgg-1",
  "telegram_gift_number": 150212,
  "telegram_gift_title": "Easter Egg",
  "telegram_nft_url": "https://t.me/nft/EasterEgg-1",
  "total_amount": 173176
}
```

--------------------------------

### Get fee per provider

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the fee information for a specific provider.

```APIDOC
## GET /providers/fee

### Description
Retrieves the fee information for a specific provider.

### Method
GET

### Endpoint
/providers/fee
```

--------------------------------

### Get gift price list history

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves historical pricing data for gifts.

```APIDOC
## GET /analytics/gifts/price/history

### Description
Retrieves historical pricing data for gifts.

### Method
GET

### Endpoint
/analytics/gifts/price/history
```

--------------------------------

### Get gifts update statistics

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves statistics related to gift updates.

```APIDOC
## GET /analytics/gifts/updates

### Description
Retrieves statistics related to gift updates.

### Method
GET

### Endpoint
/analytics/gifts/updates
```

--------------------------------

### Get attributes metadata

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves metadata for gift attributes, including backdrops, models, and symbols.

```APIDOC
## GET /api/v1/gifts/get_attributes_metadata

### Description
Retrieves metadata for gift attributes.

### Method
GET

### Endpoint
/api/v1/gifts/get_attributes_metadata

### Response
#### Success Response (200)
- **Genie Lamp** (object) - Contains backdrops, models, and symbols for the attribute.
```

--------------------------------

### Get Providers' Sales Volumes

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the sales volumes for all providers, including hourly and total revenue and sales, as well as peak hour statistics.

```json
[
  {
    "hour_revenue": 7962.049999999991,
    "hour_sales": 1679,
    "peak_hour": "2025-08-16T19:00:00+00:00",
    "peak_hour_revenue_percent": 7.73,
    "peak_hour_sales_percent": 10.65,
    "provider": "portals",
    "total_revenue": 103026.15,
    "total_sales": 15769
  }
]
```

--------------------------------

### Get the top sales volume of individual attributes per day

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the top sales volume for individual attributes on a daily basis.

```APIDOC
## GET /providers/attributes/sales/daily

### Description
Retrieves the top sales volume for individual attributes on a daily basis.

### Method
GET

### Endpoint
/providers/attributes/sales/daily
```

--------------------------------

### Get Top Deals of the Day

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves a list of the top deals available for gifts. This endpoint provides comprehensive details for each deal, including gift attributes, market data, and provider-specific information.

```APIDOC
## GET /api/v1/gifts/get_top_best_deals

### Description
Retrieves a list of the top deals available for gifts. This endpoint provides comprehensive details for each deal, including gift attributes, market data, and provider-specific information.

### Method
GET

### Endpoint
/api/v1/gifts/get_top_best_deals

### Response
#### Success Response (200)
- **getgems** (array) - A list of top deals.
  - **gift** (object) - Details of the gift.
    - **attributes** (object) - Key-value pairs of gift attributes.
      - **BACKDROP** (object) - Backdrop attributes.
        - **media** (string) - URL of the backdrop media.
        - **name** (string) - Name of the backdrop.
        - **rarity** (integer) - Rarity score of the backdrop.
        - **readable_rarity** (float) - Human-readable rarity of the backdrop.
      - **MODEL** (object) - Model attributes.
        - **media** (string) - URL of the model media.
        - **name** (string) - Name of the model.
        - **rarity** (integer) - Rarity score of the model.
        - **readable_rarity** (float) - Human-readable rarity of the model.
      - **SYMBOL** (object) - Symbol attributes.
        - **media** (string) - URL of the symbol media.
        - **name** (string) - Name of the symbol.
        - **rarity** (integer) - Rarity score of the symbol.
        - **readable_rarity** (float) - Human-readable rarity of the symbol.
    - **attributes_array** (array) - Array of gift attributes.
      - **name** (string) - Name of the attribute.
      - **rarity** (float) - Rarity of the attribute.
      - **type** (string) - Type of the attribute.
    - **collectible_id** (integer) - The collectible ID of the gift.
    - **id** (integer) - The unique ID of the gift.
    - **last_updated_at** (string) - Timestamp of the last update.
    - **market_floor** (object) - Market floor price data.
      - **avg** (float) - Average market floor price.
      - **max** (float) - Maximum market floor price.
      - **min** (float) - Minimum market floor price.
    - **media** (object) - Media details for the gift.
      - **lottie_anim** (string) - URL for Lottie animation.
      - **pics** (object) - Different sizes of preview images.
        - **large** (string) - URL for large image.
        - **medium** (string) - URL for medium image.
        - **small** (string) - URL for small image.
    - **media_preview** (string) - URL for the media preview.
    - **providers** (object) - Market data from different providers.
      - **getgems** (object) - Getgems provider data.
        - **collection_floor** (integer) - Collection floor price on Getgems.
        - **model_floor** (null) - Model floor price on Getgems (can be null).
        - **sales_stat** (object) - Sales statistics.
          - **sales_24h** (integer) - Number of sales in the last 24 hours.
          - **sales_24h_value** (integer) - Value of sales in the last 24 hours.
          - **sales_all** (integer) - Total number of sales.
          - **sales_all_value** (integer) - Total value of all sales.
      - **portals** (object) - Portals provider data.
        - **collection_floor** (integer) - Collection floor price on Portals.
        - **model_floor** (integer) - Model floor price on Portals.
        - **sales_stat** (object) - Sales statistics.
          - **sales_24h** (integer) - Number of sales in the last 24 hours.
          - **sales_24h_value** (integer) - Value of sales in the last 24 hours.
          - **sales_all** (integer) - Total number of sales.
          - **sales_all_value** (integer) - Total value of all sales.
      - **tonnel** (object) - Tonnel provider data.
        - **collection_floor** (integer) - Collection floor price on Tonnel.
        - **model_floor** (integer) - Model floor price on Tonnel.
        - **sales_stat** (object) - Sales statistics.
          - **sales_24h** (integer) - Number of sales in the last 24 hours.
          - **sales_24h_value** (integer) - Value of sales in the last 24 hours.
          - **sales_all** (integer) - Total number of sales.
          - **sales_all_value** (integer) - Total value of all sales.
    - **rarity_index** (float) - The rarity index of the gift.
    - **telegram_gift_id** (integer) - Telegram gift ID.
    - **telegram_gift_name** (string) - Telegram gift name.
    - **telegram_gift_number** (integer) - Telegram gift number.
    - **telegram_gift_title** (string) - Telegram gift title.
    - **telegram_nft_url** (string) - URL to the Telegram NFT.
    - **total_amount** (integer) - Total amount of this gift available.
  - **price** (integer) - The price of the deal.
  - **provider** (string) - The provider of the deal (e.g., "getgems").
  - **type** (string) - The type of the item (e.g., "deal").
  - **unix** (integer) - Unix timestamp for the deal.

### Request Example
(No request body or parameters are documented for this endpoint)

### Response Example
```json
{
  "getgems": [
    {
      "gift": {
        "attributes": {
          "BACKDROP": {
            "media": "https://giftasset.pro/api/v1/data/backdrops/strawberry.png",
            "name": "Strawberry",
            "rarity": 20,
            "readable_rarity": 2
          },
          "MODEL": {
            "media": "https://giftasset.pro/api/v1/data/models/sketchy.png",
            "name": "Sketchy",
            "rarity": 20,
            "readable_rarity": 2
          },
          "SYMBOL": {
            "media": "https://giftasset.pro/api/v1/data/symbols/boat.png",
            "name": "Boat",
            "rarity": 5,
            "readable_rarity": 0.5
          }
        },
        "attributes_array": [
          {
            "name": "Boat",
            "rarity": 0.5,
            "type": "SYMBOL"
          },
          {
            "name": "Sketchy",
            "rarity": 2,
            "type": "MODEL"
          },
          {
            "name": "Strawberry",
            "rarity": 2,
            "type": "BACKDROP"
          }
        ],
        "collectible_id": 239,
        "id": 811671,
        "last_updated_at": "2025-08-16T07:09:00Z",
        "market_floor": {
          "avg": 3298.667,
          "max": 3688,
          "min": 3079
        },
        "media": {
          "lottie_anim": "https://nft.fragment.com/gift/plushpepe-239.lottie.json",
          "pics": {
            "large": "https://nft.fragment.com/gift/plushpepe-239.large.jpg",
            "medium": "https://nft.fragment.com/gift/plushpepe-239.medium.jpg",
            "small": "https://nft.fragment.com/gift/plushpepe-239.small.jpg"
          }
        },
        "media_preview": "https://nft.fragment.com/gift/plushpepe-239.medium.jpg",
        "providers": {
          "getgems": {
            "collection_floor": 3079,
            "model_floor": null,
            "sales_stat": {
              "sales_24h": 3,
              "sales_24h_value": 9590,
              "sales_all": 53,
              "sales_all_value": 200911
            }
          },
          "portals": {
            "collection_floor": 3129,
            "model_floor": 4399,
            "sales_stat": {
              "sales_24h": 3,
              "sales_24h_value": 11760,
              "sales_all": 411,
              "sales_all_value": 1613905
            }
          },
          "tonnel": {
            "collection_floor": 3688,
            "model_floor": 4000,
            "sales_stat": {
              "sales_24h": 0,
              "sales_24h_value": 0,
              "sales_all": 541,
              "sales_all_value": 906893
            }
          }
        },
        "rarity_index": 0.0002,
        "telegram_gift_id": 6028603284225263000,
        "telegram_gift_name": "PlushPepe-239",
        "telegram_gift_number": 2822,
        "telegram_gift_title": "Plush Pepe",
        "telegram_nft_url": "https://t.me/nft/PlushPepe-239",
        "total_amount": 2861
      },
      "price": 3600,
      "provider": "getgems",
      "type": "deal",
      "unix": 1755351027
    }
  ]
}
```
```

--------------------------------

### Get Gift Prices

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Fetches the current floor prices for gift collections across different marketplaces. The response includes prices from 'getgems' and 'tonnel', along with the last update timestamp.

```json
{
  "collection_floors": {
    "Astral Shard": {
      "getgems": 76,
      "last_update": "2025-08-17T11:08:44+00:00",
      "portals": 79,
      "tonnel": 84.9
    }
  }
}
```

--------------------------------

### Get sales history of current provider

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the sales history for the current provider.

```APIDOC
## GET /providers/sales/history

### Description
Retrieves the sales history for the current provider.

### Method
GET

### Endpoint
/providers/sales/history
```

--------------------------------

### Get Providers' Sales Volumes

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the sales volumes for all providers, including revenue, sales counts, and peak performance metrics.

```APIDOC
## GET /api/v1/gifts/get_providers_volumes

### Description
Get providers' sales volumes.

### Method
GET

### Endpoint
/api/v1/gifts/get_providers_volumes

### Response
#### Success Response (200)
- **hour_revenue** (number) - The revenue generated in the peak hour.
- **hour_sales** (integer) - The number of sales in the peak hour.
- **peak_hour** (string) - The timestamp of the peak hour (ISO 8601 format).
- **peak_hour_revenue_percent** (number) - The percentage of total revenue generated in the peak hour.
- **peak_hour_sales_percent** (number) - The percentage of total sales made in the peak hour.
- **provider** (string) - The name of the provider.
- **total_revenue** (number) - The total revenue generated.
- **total_sales** (integer) - The total number of sales.

### Response Example
```json
[
  {
    "hour_revenue": 7962.049999999991,
    "hour_sales": 1679,
    "peak_hour": "2025-08-16T19:00:00+00:00",
    "peak_hour_revenue_percent": 7.73,
    "peak_hour_sales_percent": 10.65,
    "provider": "portals",
    "total_revenue": 103026.15,
    "total_sales": 15769
  }
]
```
```

--------------------------------

### GET /api/v1/gifts/get_attribute_volumes

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the top sales volume of individual attributes per day.

```APIDOC
## GET /api/v1/gifts/get_attribute_volumes

### Description
Retrieves the top sales volume of individual attributes per day, including collection name, attribute name, sales count, and sales sum.

### Method
GET

### Endpoint
/api/v1/gifts/get_attribute_volumes

### Response
#### Success Response (200)
- **getgems** (object) - An object containing attribute volumes, where keys are attribute names and values are arrays of sales data.
  - **collection_name** (string) - The name of the collection.
  - **name** (string) - The name of the attribute.
  - **sales_count** (integer) - The number of sales for the attribute.
  - **sales_sum** (string) - The total sales sum for the attribute.

#### Response Example
```json
{
  "getgems": {
    "backdrops": [
      {
        "collection_name": "Lol Pop",
        "name": "Steel Grey",
        "sales_count": 14,
        "sales_sum": "27.66"
      },
      {
        "collection_name": "B-Day Candle",
        "name": "Ivory White",
        "sales_count": 13,
        "sales_sum": "25.04"
      }
    ]
  }
}
```
```

--------------------------------

### Get User Profile Price

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieve the cost of a user's profile, including collection and model prices across different platforms. Requires username and a limit for pagination.

```json
{
  "gifts": [
    {
      "collection_prices": {
        "getgems": 76,
        "portals": 79,
        "tonnel": 85
      },
      "model_prices": {
        "getgems": 100,
        "portals": 130,
        "tonnel": 90
      },
      "name": "AstralShard-2072"
    }
  ],
  "total_collection_price": {
    "getgems": 76,
    "portals": 79,
    "tonnel": 85
  },
  "total_model_price": {
    "getgems": 100,
    "portals": 130,
    "tonnel": 90
  }
}
```

--------------------------------

### Get Sales History of Current Provider

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the sales history for a specific provider. Requires 'provider_name', 'limit', and 'offset' as query parameters.

```json
[
  {
    "collection_name": "Jelly Bunny",
    "price": 5,
    "provider": "tonnel",
    "telegram_gift_id": 5965079038585210000,
    "telegram_gift_name": "JellyBunny-56865",
    "telegram_gift_number": 85212,
    "unix_time": 1755428712
  }
]
```

--------------------------------

### GET /api/v1/gifts/get_user_profile_price

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the cost of a user's profile, including collection and model prices for various platforms.

```APIDOC
## GET /api/v1/gifts/get_user_profile_price

### Description
Retrieves the cost of a user's profile, including collection and model prices for various platforms.

### Method
GET

### Endpoint
/api/v1/gifts/get_user_profile_price

### Parameters
#### Query Parameters
- **username** (string) - Required - The username to fetch profile prices for.
- **limit** (integer) - Required - The number of results to return.
- **offset** (integer) - Optional - The offset for pagination.

### Response
#### Success Response (200)
- **gifts** (array) - A list of gift items with their collection and model prices.
- **total_collection_price** (object) - The total collection price across different platforms.
- **total_model_price** (object) - The total model price across different platforms.

#### Response Example
```json
{
  "gifts": [
    {
      "collection_prices": {
        "getgems": 76,
        "portals": 79,
        "tonnel": 85
      },
      "model_prices": {
        "getgems": 100,
        "portals": 130,
        "tonnel": 90
      },
      "name": "AstralShard-2072"
    }
  ],
  "total_collection_price": {
    "getgems": 76,
    "portals": 79,
    "tonnel": 85
  },
  "total_model_price": {
    "getgems": 100,
    "portals": 130,
    "tonnel": 90
  }
}
```
```

--------------------------------

### Get gift price list history

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves historical price data for gift collections over different timeframes.

```APIDOC
## GET /api/v1/gifts/get_gifts_price_list_history

### Description
Retrieves historical price data for gift collections.

### Method
GET

### Endpoint
/api/v1/gifts/get_gifts_price_list_history

### Response
#### Success Response (200)
- **portals** (object) - Historical price data for the Portals marketplace.
  - **24h** (object) - Price data for the last 24 hours.
    - **timestamp** (string) - The timestamp of the price.
    - **price** (number) - The price at that timestamp.
  - **7d** (object) - Price data for the last 7 days (empty if no data).
  - **current_price** (number) - The current price on Portals.
- **tonnel** (object) - Historical price data for the Tonnel marketplace (structure similar to portals).
```

--------------------------------

### Get Fee Per Provider

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the fee associated with each provider. The response is an array of objects, each containing the fee and the provider's name.

```json
[
  {
    "fee": 5,
    "provider": "portals"
  },
  {
    "fee": 3,
    "provider": "tonnel"
  },
  {
    "fee": 0,
    "provider": "getgems"
  }
]
```

--------------------------------

### Get Gifts Collections Marketcap

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the market capitalization data for various gift collections, including floor price and total market cap in TON.

```APIDOC
## GET /api/v1/gifts/get_gifts_collections_marketcap

### Description
Retrieves the market capitalization data for various gift collections.

### Method
GET

### Endpoint
/api/v1/gifts/get_gifts_collections_marketcap

### Response
#### Success Response (200)
- **getgems** (array) - A list of gift collection market cap data.
  - **available_gifts** (integer) - The number of available gifts in the collection.
  - **collection_name** (string) - The name of the gift collection.
  - **floor** (string) - The floor price of the collection.
  - **ton_mcap** (integer) - The total market cap of the collection in TON.

### Response Example
```json
{
  "getgems": [
    {
      "available_gifts": 5359,
      "collection_name": "Astral Shard",
      "floor": "85.00",
      "ton_mcap": 455515
    }
  ]
}
```
```

--------------------------------

### Get Unique Deals of Providers

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

This endpoint retrieves unique deals for gift assets, detailing provider-specific information such as collection floor prices and sales statistics. The response includes comprehensive gift attributes and market data.

```json
{
  "getgems": [
    {
      "gift": {
        "attributes": {
          "BACKDROP": {
            "name": "Battleship Grey",
            "rarity": 12,
            "readable_rarity": 1.2
          },
          "MODEL": {
            "name": "Monkey Mouse",
            "rarity": 20,
            "readable_rarity": 2
          },
          "SYMBOL": {
            "name": "Paper Crane",
            "rarity": 4,
            "readable_rarity": 0.4
          }
        },
        "attributes_array": [
          {
            "name": "Paper Crane",
            "rarity": 0.4,
            "type": "SYMBOL"
          },
          {
            "name": "Battleship Grey",
            "rarity": 1.2,
            "type": "BACKDROP"
          },
          {
            "name": "Monkey Mouse",
            "rarity": 2,
            "type": "MODEL"
          }
        ],
        "collectible_id": 21755,
        "id": 2083981,
        "last_updated_at": "2025-09-02T08:52:21Z",
        "market_floor": {
          "avg": 1.865,
          "max": 2.56,
          "min": 0
        },
        "media": {
          "lottie_anim": "https://nft.fragment.com/gift/jollychimp-21755.lottie.json",
          "pics": {
            "large": "https://nft.fragment.com/gift/jollychimp-21755.large.jpg",
            "medium": "https://nft.fragment.com/gift/jollychimp-21755.medium.jpg",
            "small": "https://nft.fragment.com/gift/jollychimp-21755.small.jpg"
          }
        },
        "media_preview": "https://nft.fragment.com/gift/jollychimp-21755.medium.jpg",
        "providers": {
          "getgems": {
            "collection_floor": 2.5,
            "sales_stat": {
              "sales_24h": 9,
              "sales_24h_value": 93,
              "sales_all": 9,
              "sales_all_value": 93
            }
          },
          "mrkt": {
            "collection_floor": 2.56,
            "sales_stat": {
              "sales_24h": 202,
              "sales_24h_value": 667,
              "sales_all": 202,
              "sales_all_value": 667
            }
          },
          "portals": {
            "collection_floor": 0,
            "sales_stat": {
              "sales_24h": 1110,
              "sales_24h_value": 5496,
              "sales_all": 1110,
              "sales_all_value": 5496
            }
          },
          "tonnel": {
            "collection_floor": 2.4,
            "sales_stat": {
              "sales_24h": 230,
              "sales_24h_value": 1085,
              "sales_all": 230,
              "sales_all_value": 1085
            }
          }
        },
        "rarity_index": 0.0001,
        "telegram_gift_id": 5825670855492897000,
        "telegram_gift_name": "JollyChimp-21755",
        "telegram_gift_number": 94177,
        "telegram_gift_title": "Jolly Chimp",
        "telegram_nft_url": "https://t.me/nft/JollyChimp-21755",
        "total_amount": 132155
      },
      "price": 25,
      "telegram_gift_name": "JollyChimp-21755",
      "unix": 1756802702
    }
  ]
}
```

--------------------------------

### Get Top Sales Volume of Collections per Time

Source: https://github.com/killmode696/giftasset/blob/main/DOCS.md

Retrieves the top sales volume of individual collections within a specified time frame. Requires a 'maxtime' integer parameter in seconds.

```json
{
  "getgems": {
    "collections": [
      {
        "collection_name": "Snoop Dogg",
        "name": "Snoop Dogg",
        "sales_count": 1,
        "sales_sum": "2.00"
      }
    ]
  }
}
```