Gheymat

A simple Python package for getting live prices of currencies, cryptocurrencies, gold, coins, and precious metals.

If this package is useful for you, you can support me with a coffee ☕😁

https://www.coffeebede.com/mrrobat

Installation

pip install gheymat

Supported Prices

Currencies

Cryptocurrencies

Gold, Coins, and Metals

Usage

Get Currency Prices

You can use the new get_price() function to get the price of any supported currency.

from gheymat.currency import get_price

Get US Dollar Price in Toman

dollar_price = get_price("usd", toman=True)
print(dollar_price)

Get Euro Price in Rial

euro_price = get_price("eur", toman=False)
print(euro_price)

Get Pound Price With Commas

pound_price = get_price("gbp", toman=True, beauty=True)
print(pound_price)

# Example output:
# 1,520,000

The currency name is not case-sensitive:

get_price("usd")
get_price("USD")
get_price("Usd")

All of them work the same.

get_price() Parameters

Supported currency values:

usd, gbp, eur, try, aed, cny, inr, sek, omr

Old Currency Functions

The old functions are still available and will continue to work.

from gheymat.currency import USD, EUR

dollar_price = USD(toman=True, beauty=False)
euro_price = EUR(toman=False, beauty=True)

print(dollar_price)
print(euro_price)

For new projects, using get_price() is recommended.

Cryptocurrency Prices

You can get cryptocurrency prices with their own functions.

from gheymat.crypto import BTC, ETH, DOGE

bitcoin_price = BTC(toman=True, beauty=True)
ethereum_price = ETH(toman=False)
dogecoin_price = DOGE(toman=True)

print(bitcoin_price)
print(ethereum_price)
print(dogecoin_price)

Cryptocurrency Function Parameters

Gold and Metal Prices

from gheymat.metal import GOLD18, GOLD24, SEKE_EMAM, SILVER

gold_18_price = GOLD18(toman=True, beauty=True)
gold_24_price = GOLD24(toman=True)
emami_coin_price = SEKE_EMAM(toman=True, beauty=True)
silver_price = SILVER(toman=False)

print(gold_18_price)
print(gold_24_price)
print(emami_coin_price)
print(silver_price)

Gold and Metal Function Parameters

Notes

• Prices are collected from online sources and may change at any time.
• This package depends on the structure of source websites. If a source website changes its HTML structure, some functions may need an update.
• Use the returned prices for informational purposes only.
• When beauty=True, the returned value is a str.
• When beauty=False, the returned value is usually an int or float.

Support

If you like this package and want to support its development, you can buy me a coffee ☕😁 https://www.coffeebede.com/mrrobat

License

This project is available under the MIT License.