Skip to main content

Foreign exchange rates and currency conversion.

Project description Code Health

Forex Python is a Free Foreign exchange rates and currency conversion.


  • List all currency rates.

  • BitCoin price for all curuncies.

  • Converting amount to BitCoins.

  • Get historical rates for any day since 1999.

  • Conversion rate for one currency(ex; USD to INR).

  • Convert amount from one currency to other.(‘USD 10$’ to INR).

  • Currency symbols.

  • Currency names.

Currency Source: is a free API for current and historical foreign exchange rates published by European Central Bank. The rates are updated daily 3PM CET.

BitCoin Price Source:

Bitcoin prices calculated every minute. For more infomation visit [CoinDesk API](


  • Install using python package

    pip install forex-python
            Or directly cloning the repo:
    python install

Usage Examples:

  • Initialize class

    >>> from forex_python.converter import CurrencyRates
    >>> c = CurrencyRates()
  • list all latest currency rates for “USD”

    >>> c.get_rates('USD')
    {u'IDR': 13625.0, u'BGN': 1.7433, u'ILS': 3.8794, u'GBP': 0.68641, u'DKK': 6.6289, u'CAD': 1.3106, u'JPY': 110.36, u'HUF': 282.36, u'RON': 4.0162, u'MYR': 4.081, u'SEK': 8.3419, u'SGD': 1.3815, u'HKD': 7.7673, u'AUD': 1.3833, u'CHF': 0.99144, u'KRW': 1187.3, u'CNY': 6.5475, u'TRY': 2.9839, u'HRK': 6.6731, u'NZD': 1.4777, u'THB': 35.73, u'EUR': 0.89135, u'NOK': 8.3212, u'RUB': 66.774, u'INR': 67.473, u'MXN': 18.41, u'CZK': 24.089, u'BRL': 3.5473, u'PLN': 3.94, u'PHP': 46.775, u'ZAR': 15.747}
  • Get conversion rate from USD to INR

    >>> c.get_rate('USD', 'INR')
  • Convert amount from USD to INR

    >>> c.convert('USD', 'INR', 10)
  • Get latest Bitcoin price.

    >>> from forex_python.bitcoin import BtcConverter
    >>> b = BtcConverter()
    >>> b.get_latest_price('USD')
  • Convert Amount to Bitcoins based on latest exchange price.

    >>> b.convert_to_btc(400, 'USD')
  • Get currency symbol using currency code

    >>> from forex_python.converter import CurrencyCodes
    >>> c = CurrencyCodes()
    >>> print c.get_symbol('GBP')

You can view the complete Documentation Here

We welcome your feedback and support, raise github ticket if you want to report a bug. Need new features? Contact us here

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

forex-python-0.3.1.tar.gz (7.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page