Skip to main content

A RESTful API for currency symbols and codes for countries across the world.

Project description

Vengeance World Currency API

Welcome to the Currency API, a powerful and easy-to-use RESTful API designed to provide comprehensive currency symbols and codes for various countries around the globe. This API is perfect for developers looking to integrate currency information into their applications.

Features

  • Simple Integration: Effortlessly integrate currency data into your applications.
  • Comprehensive Coverage: Access currency information for numerous countries.
  • Lightweight: Designed to be lightweight and fast, ensuring optimal performance.

Installation

Step 1: Clone the Repository

To get started, clone the repository to your local machine:

git clone https://github.com/preetham-1811/currency-api.git cd currency-api

Step 2: Install Dependencies

Next, install the required dependencies using pip:

pip install -r requirements.txt

Usage

To run the API, follow these steps:

  1. Import the CurrencyAPI class from the package.
  2. Create an instance of the API.
  3. Call the run method to start the server.
from currency_api import CurrencyAPI

api = CurrencyAPI()
api.run()

Once the server is running, you can access the API endpoints.

API Endpoints

Get Currency Information for a Specific Country

  • Endpoint: GET /currency/<country>
  • Description: Retrieve detailed currency information (symbol and code) for a specific country.
  • Example:
    • Request: /currency/Albania
    • Response: { "symbol": "Lek", "code": "ALL" }

Retrieve a List of All Available Currencies

  • Endpoint: GET /currencies
  • Description: Get a comprehensive list of all available currencies along with their symbols and codes.
  • Response:
    • Example Output:
    [
        { "country": "Albania", "symbol": "Lek", "code": "ALL" }
    ]
    

Contributing

We welcome contributions! If you'd like to contribute to the Currency API, please fork the repository and submit a pull request. Your help in improving this API is greatly appreciated!

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Support

If you have any questions or need support, feel free to open an issue on GitHub or reach out directly.


Feel free to adjust any sections or add more details specific to your project! This structure provides clear guidance and encourages engagement with the API.

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

vengeance_currency_api-1.2.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vengeance_currency_api-1.2-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

Details for the file vengeance_currency_api-1.2.tar.gz.

File metadata

  • Download URL: vengeance_currency_api-1.2.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.2

File hashes

Hashes for vengeance_currency_api-1.2.tar.gz
Algorithm Hash digest
SHA256 a75632621ee49f09e5a33a4b8f31ed2c4451f6abd3035bbe9c63615f20cea411
MD5 62a58c4dbf6ca07da82d06a41ff4b0d7
BLAKE2b-256 78f21dc2426eb1f4d4ff91e6f6ebe12c46f37993f2fb2289f23b68ae2518d5bc

See more details on using hashes here.

File details

Details for the file vengeance_currency_api-1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for vengeance_currency_api-1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1eab06b2c6354c2a179690c7fe8b0673b5db4e4afe24ab7058d5a3fd10114c3e
MD5 da33f0601fe15c3869adae7f6dec1098
BLAKE2b-256 316074169a02f1a079ff1c2e9ac2caf702766db23fbcfee1765276a884eb3355

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page