topOffer

topOffer()

async def topOffer(gift_name: str, authData: str) -> CollectionOffer

Retrieve top-price offer for the gift collection by gift name

Returns

CollectionOffer object

Raises

• authDataError if authData is not provided

• offerError if gift_name isn't provided or is invalid

• requestError if request fails.

Parameters

• gift_name (str): name of the gift collection

• authData (str): Authentication data required to cancel the offer.

CollectionOffer object

Methods

• .toDict() - converts the CollectionOffer object back to a dict

Attributes

• .id - retrieves offer_id

• .collection_id - the id of the collection

• .sender_id - id of the offer sender (as far as i know its always None)

• .amount - amount of TON offered

• .max_nfts - how many nfts can be bought with this offer

• .current_nfts - how many nfts have already been bought with this offer

• .status - status of the offer

• .created_at - date+time of when the offer was created

• .updated_at - date+time of when the offer was updated (if was)

• .expires_at - expiration date+time of the offer

• .name - name of the gift collection

• .short_name - short name of the gift collection

• .photo_url - url link to the photo that represents the gift collection

• .floor_price - lowest price for the gift from the collection

Example

from aportalsmp.offers import topOffer
from aportalsmp.auth import update_auth
import asyncio

auth = asyncio.run(update_auth(api_id=123, api_hash="..."))

async def main():
    top = await allCollectionOffers(gift_name = "Plush Pepe", authData = auth)
    print(top.amount, top.id)

See used functions: update_auth