No project description provided
Project description
Documentation
Description:
This Python library provides functionalities to get cryptocurrency prices and perform conversions between Iranian Toman (IRT) and USD, for 15 supported cryptocurrencies.
Key Features:
-
Get the current price of various cryptocurrencies in IRT or USD.
-
Convert between IRT and USD for any of the supported cryptocurrencies.
-
Donate to the library developer (optional).
Supported Cryptocurrencies:
TON
BTC
ETH
USDT
SHIB
BNB
DOGE
ADA
SOL
XRP
USDC
ETC
PEPE
ATM
BISO
Installation
pip install YnExchangePY
Functionality
The library provides functions for retrieving the price of 15 cryptocurrencies. Each function takes two arguments:
-
currency (str): This argument specifies the desired currency (either "IRT" or "USD").
-
grouping (bool, optional): This argument is optional (defaults to False). If set to True, the function will format the price with comma separators for readability.
Here's a list of all the available functions:
-
yn_exchange.TON_PRICE(currency, grouping=False)
-
yn_exchange.BTC_PRICE(currency, grouping=False)
-
yn_exchange.ETH_PRICE(currency, grouping=False)
-
yn_exchange.USDT_PRICE(currency, grouping=False)
-
yn_exchange.SHIB_PRICE(currency, grouping=False)
-
yn_exchange.BNB_PRICE(currency, grouping=False)
-
yn_exchange.DOGE_PRICE(currency, grouping=False)
-
yn_exchange.ADA_PRICE(currency, grouping=False)
-
yn_exchange.SOL_PRICE(currency, grouping=False)
-
yn_exchange.XRP_PRICE(currency, grouping=False)
-
yn_exchange.USDC_PRICE(currency, grouping=False)
-
yn_exchange.ETC_PRICE(currency, grouping=False)
-
yn_exchange.PEPE_PRICE(currency, grouping=False)
-
yn_exchange.ATM_PRICE(currency, grouping=False)
Example Usage
from YN_Exchange import yn_exchange
# Get Bitcoin price in USD with comma separators
bitcoin_usd_price = yn_exchange.BTC_PRICE("USD", grouping=True)
print(f"Bitcoin price in USD: ${bitcoin_usd_price}")
# Get Ethereum price in IRT
ethereum_irt_price = yn_exchange.ETH_PRICE("IRT")
print(f"Ethereum price in IRT: {ethereum_irt_price}")
Error Handling
If the function encounters an error, such as an invalid currency or a network issue, it will raise a ValueError
exception. You can handle this exception using a try-except block.
Limitations
-
The library relies on scraping data from a website, which may be subject to changes or become unavailable.
-
The library only supports a limited number of cryptocurrencies (currently 15).
Additional notes
Here are some ways you can contribute to the YN_Exchange project:
- Donate: If you've found my library to be useful, I would greatly appreciate it if you would consider making a donation. Your donation will help me to continue to develop and maintain the library, and to add new features in the future.
Donate function
yn_exchange.donate()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for YnExchangePY-2.5.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df5a3eb8735130641ce50a098f934164efb692491728f59e79847c0e3525b1b1 |
|
MD5 | 2de0a664413437f9c269da437059bc83 |
|
BLAKE2b-256 | 374e0e44ef63efab5843c86a3163d3a371c376b61d4b70a6d7ba832d2f7ccd6f |