Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/athammad/pygcapi
The pygcapi package provides an interface to the Gain Capital API V1 and V2, enabling users to perform various trading operations on Forex.com.
https://github.com/athammad/pygcapi
api forex-data object-oriented-programming python trading trading-algorithms trading-strategies
Last synced: 3 days ago
JSON representation
The pygcapi package provides an interface to the Gain Capital API V1 and V2, enabling users to perform various trading operations on Forex.com.
- Host: GitHub
- URL: https://github.com/athammad/pygcapi
- Owner: athammad
- License: mit
- Created: 2024-11-11T03:48:48.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-24T04:20:29.000Z (10 days ago)
- Last Synced: 2024-12-24T04:29:45.805Z (10 days ago)
- Topics: api, forex-data, object-oriented-programming, python, trading, trading-algorithms, trading-strategies
- Language: Python
- Homepage: https://athammad.github.io/pygcapi/
- Size: 1.35 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pygcapi 
The **pygcapi** Python library provides an interface to the **Gain Capital API** (V1 and V2), allowing users to perform various trading operations on [Forex.com](https://forex.com). This library includes functionalities for account management, market information retrieval, trading operations, and historical data extraction. It also includes helper utilities and lookup tables to facilitate the interpretation of API responses.
By leveraging the extensive Python ecosystem—which includes libraries for data manipulation, scientific computing, and machine learning—**pygcapi** offers a robust solution for traders and data scientists seeking to enhance their trading operations and develop automated trading strategies.
## Features
- **Account Management**: Initialize sessions and manage user accounts.
- **Market Information**: Retrieve real-time market data and details.
- **Trading Operations**: Execute trades, manage orders, and track positions.
- **Historical Data**: Extract and analyze historical market data.
- **Helper Functions**: Utilize various helper functions and lookup tables for easier API response interpretation.
## Installation
You can install this package directly from PyPI using `pip`:
```bash
pip install pygcapi
```
Or from GitHub:
```bash
pip install git+https://github.com/athammad/pygcapi.git
```
# API Credentials
To access your trading account, you will need credentials provided by Forex.com, including a username, password, and appkey. Once obtained, you can use these credentials to initialize a session with GCapiClient:
```python
from pygcapi.core_v2 import GCapiClientV2
# Replace with your actual credentials
IDLOG = "your_username"
PSWD = "your_password"
APKEY = "your_appkey"
client = GCapiClientV2(username=IDLOG, password=PSWD, appkey=APKEY)
```
# Example Usage
```python
#Retrieve Account Information:
account_info = client.get_account_info()
print(account_info)
# Retrieve a specific field (e.g., TradingAccountId)
trading_account_id = client.get_account_info(key="TradingAccountId")
print(trading_account_id)
#Get Market Information:
market_info = client.get_market_info("EUR/USD")
print(market_info)
market_id = client.get_market_info("EUR/USD", key="MarketId")
market_name = client.get_market_info("EUR/USD", key="Name")
print(market_id)
print(market_name)
#Retrieve Price Data
import time
import datetime
from datetime import timedelta
# Define time period
one_month_ago = int((datetime.datetime.utcnow() - timedelta(days=30)).timestamp())
now = int(datetime.datetime.utcnow().timestamp())
prices = client.get_prices(
market_id=market_id,
num_ticks=100,
from_ts=one_month_ago,
to_ts=now,
price_type="MID"
)
print(prices.head())
#Retrieve OHLC Data
one_day_ago = int((datetime.datetime.utcnow() - timedelta(days=1)).timestamp())
ohlc = client.get_ohlc(
market_id=market_id,
num_ticks=4000,
interval="MINUTE",
span=30,
from_ts=one_day_ago,
to_ts=now
)
print(ohlc.head())
# Place a Trade Order:
pricesB = client.get_prices(market_id=market_id, from_ts=from_ts,to_ts=to_ts, num_ticks=1,price_type="BID")
pricesA=client.get_prices(market_id=market_id, from_ts=from_ts,to_ts=to_ts, num_ticks=1,price_type="ASK")
trade_resp = client.trade_order(
quantity=1020,
direction="buy",
market_id=market_id,
market_name=market_name,
bid_price=float(pricesB.Price[0]), # Convert to scalar float
offer_price=float(pricesA.Price[0]) # Convert to scalar float
)
# Close a Trade Order:
close_resp = client.trade_order(
quantity=1020,
direction="sell",
close=True,
order_id=trade_resp.get('OrderId'),
market_id=market_id,
market_name=market_name,
bid_price=float(pricesB.Price[0]), # Convert to scalar float
offer_price=float(pricesA.Price[0]) # Convert to scalar float
)
#List Open Positions:
open_positions = client.list_open_positions()
print(open_positions)
#Close All Trades:
close_responses = client.close_all_trades(tolerance=0.0005)
print(close_responses)
#Retrieve Trade History:
trade_history = client.get_trade_history(max_results=50)
print(trade_history)
```
## Getting Help or Reporting an Issue
To report bugs/issues/feature requests, please file an [issue](https://github.com/athammad/pygcapi/issues/).
## Author
`pygcapi` is written by [Ahmed T. Hammad](https://athsas.com/) and is under active development. Please feel free to contribute by submitting any issues or requests—or by solving any current issues!
## R version
If you prefer `R`, you can use the [rgcapi library](https://github.com/athammad/rgcapi/).
## Disclaimer
This package is not supported by `Forex.com`, and the author does not hold any responsibility for how users decide to use the library. Use it at your own risk.
## Official API documentation
https://docs.labs.gaincapital.com/index.html