ctrader-oauth-fetcher 1.0.0__tar.gz

ctrader_oauth_fetcher-1.0.0/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# IDE-specific files
+.idea/
+.vscode/

ctrader_oauth_fetcher-1.0.0/.python-version

@@ -0,0 +1 @@
+3.14

ctrader_oauth_fetcher-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elio Anthony Chukri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ctrader_oauth_fetcher-1.0.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: ctrader-oauth-fetcher
+Version: 1.0.0
+Summary: One-time OAuth token fetcher for cTrader Open API
+License-File: LICENSE
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# ctrader-oauth-fetcher
+
+A command-line utility for obtaining OAuth tokens from the cTrader Open API. This tool automates the OAuth 2.0 authorization code flow, handling browser-based authorization and token exchange.
+
+## Requirements
+
+- Python 3.14+
+- A cTrader Open API application (client ID and secret)
+
+## Usage
+
+Run directly without installation using uvx:
+
+```bash
+uvx ctrader-oauth-fetcher --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
+```
+
+With all options:
+
+```bash
+ctrader-oauth-fetcher \
+  --client-id YOUR_CLIENT_ID \
+  --client-secret YOUR_CLIENT_SECRET \
+  --scope trading \
+  --redirect-uri http://localhost:8080
+```
+
+### Options
+
+| Option            | Required | Default                 | Description                               |
+|-------------------|----------|-------------------------|-------------------------------------------|
+| `--client-id`     | Yes      | -                       | OAuth application client ID               |
+| `--client-secret` | Yes      | -                       | OAuth application client secret           |
+| `--scope`         | No       | `trading`               | Permission scope: `trading` or `accounts` |
+| `--redirect-uri`  | No       | `http://localhost:8080` | OAuth callback URL                        |
+
+### Scopes
+
+- `trading` - Full trading permissions (place orders, manage positions)
+- `accounts` - Read-only access to account information
+
+## How It Works
+
+1. The tool constructs an authorization URL and opens it in your default browser
+2. A local HTTP server starts to listen for the OAuth callback
+3. After you authorize the application in your browser, cTrader redirects back to the local server
+4. The tool exchanges the authorization code for access and refresh tokens
+5. Tokens are displayed in the terminal
+
+## Output
+
+On success, the tool outputs the token response:
+
+```
+Tokens Received successfully.
+
+Access token: <TOKEN>
+Refresh token: <TOKEN>
+Expires in: <SECONDS> seconds
+```
+
+## Getting cTrader API Credentials
+
+1. Go to [cTrader Open API](https://openapi.ctrader.com/)
+2. Register or log in to your account
+3. Create a new application
+4. Note your client ID and client secret
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

ctrader_oauth_fetcher-1.0.0/README.md

@@ -0,0 +1,71 @@
+# ctrader-oauth-fetcher
+
+A command-line utility for obtaining OAuth tokens from the cTrader Open API. This tool automates the OAuth 2.0 authorization code flow, handling browser-based authorization and token exchange.
+
+## Requirements
+
+- Python 3.14+
+- A cTrader Open API application (client ID and secret)
+
+## Usage
+
+Run directly without installation using uvx:
+
+```bash
+uvx ctrader-oauth-fetcher --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
+```
+
+With all options:
+
+```bash
+ctrader-oauth-fetcher \
+  --client-id YOUR_CLIENT_ID \
+  --client-secret YOUR_CLIENT_SECRET \
+  --scope trading \
+  --redirect-uri http://localhost:8080
+```
+
+### Options
+
+| Option            | Required | Default                 | Description                               |
+|-------------------|----------|-------------------------|-------------------------------------------|
+| `--client-id`     | Yes      | -                       | OAuth application client ID               |
+| `--client-secret` | Yes      | -                       | OAuth application client secret           |
+| `--scope`         | No       | `trading`               | Permission scope: `trading` or `accounts` |
+| `--redirect-uri`  | No       | `http://localhost:8080` | OAuth callback URL                        |
+
+### Scopes
+
+- `trading` - Full trading permissions (place orders, manage positions)
+- `accounts` - Read-only access to account information
+
+## How It Works
+
+1. The tool constructs an authorization URL and opens it in your default browser
+2. A local HTTP server starts to listen for the OAuth callback
+3. After you authorize the application in your browser, cTrader redirects back to the local server
+4. The tool exchanges the authorization code for access and refresh tokens
+5. Tokens are displayed in the terminal
+
+## Output
+
+On success, the tool outputs the token response:
+
+```
+Tokens Received successfully.
+
+Access token: <TOKEN>
+Refresh token: <TOKEN>
+Expires in: <SECONDS> seconds
+```
+
+## Getting cTrader API Credentials
+
+1. Go to [cTrader Open API](https://openapi.ctrader.com/)
+2. Register or log in to your account
+3. Create a new application
+4. Note your client ID and client secret
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

ctrader_oauth_fetcher-1.0.0/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from ctrader-oauth-fetcher!")
+
+
+if __name__ == "__main__":
+    main()

ctrader_oauth_fetcher-1.0.0/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "ctrader-oauth-fetcher"
+version = "1.0.0"
+readme = "README.md"
+description = "One-time OAuth token fetcher for cTrader Open API"
+requires-python = ">=3.14"
+dependencies = []
+
+[project.scripts]
+ctrader-oauth-fetcher = "ctrader_oauth_fetcher.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

ctrader_oauth_fetcher-1.0.0/src/ctrader_oauth_fetcher/cli.py

@@ -0,0 +1,107 @@
+import argparse
+import webbrowser
+import json
+import sys
+from http.server import HTTPServer, BaseHTTPRequestHandler
+from urllib.parse import urlparse, parse_qs, urlencode
+from urllib.request import urlopen
+from urllib.error import HTTPError
+
+def eprint(msg: str) -> None:
+    print(msg, file=sys.stderr)
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "--client-id", required=True, help="Client ID used to authorize the application"
+    )
+    parser.add_argument(
+        "--client-secret",
+        required=True,
+        help="Client Secret used to authorize the application",
+    )
+    parser.add_argument(
+        "--scope", default="trading", help="The scope of the permissions to authorize for the application. Must be one of 'accounts' or 'trading'",
+    )
+    parser.add_argument(
+        "--redirect-uri",
+        default="http://localhost:8080",
+        help="Redirect URI registered with your application. Defaults to http://localhost:8080",
+    )
+    args = parser.parse_args()
+
+    if args.scope not in ["accounts", "trading"]:
+        eprint("Invalid scope. Must be one of 'accounts' or 'trading'")
+        sys.exit(1)
+
+    auth_code = None
+    auth_error = None
+
+    class Handler(BaseHTTPRequestHandler):
+        def do_GET(self):
+            nonlocal auth_code, auth_error
+            params = parse_qs(urlparse(self.path).query)
+            if "error" in params:
+                auth_error = params["error"][0]
+            elif "code" in params:
+                auth_code = params["code"][0]
+            else:
+                auth_error = "No code or error returned in redirect"
+            self.send_response(200)
+            self.end_headers()
+            self.wfile.write(b"Authorization complete. You can close this tab.")
+
+        def log_message(self, format: str, *args):
+            pass
+
+    auth_url = (
+        f"https://id.ctrader.com/my/settings/openapi/grantingaccess/"
+        f"?client_id={args.client_id}"
+        f"&redirect_uri={args.redirect_uri}"
+        f"&scope={args.scope}"
+        f"&product=web"
+    )
+
+    parsed = urlparse(args.redirect_uri)
+    host = parsed.hostname
+    port = parsed.port or 80
+
+    opened = webbrowser.open(auth_url)
+    if not opened:
+        print(f"Could not open browser. Visit this URL manually:\n{auth_url}")
+    else:
+        print("Browser opened. Complete the authorization in your browser.")
+
+    print("Waiting for authorization...")
+    HTTPServer((host, int(port)), Handler).handle_request()
+
+    if auth_error:
+        eprint(f"Authorization failed: {auth_error}")
+        sys.exit(1)
+
+    print("Authorization code received. Exchanging for tokens...")
+    url_params = urlencode(
+
+        {
+            "grant_type": "authorization_code",
+            "code": auth_code,
+            "redirect_uri": args.redirect_uri,
+            "client_id": args.client_id,
+            "client_secret": args.client_secret,
+        }
+    )
+
+    try:
+        with urlopen(
+            f"https://openapi.ctrader.com/apps/token?{url_params}"
+        ) as response:
+            tokens = json.loads(response.read())
+    except HTTPError as e:
+        body = e.read().decode()
+        eprint(f"Token exchange failed ({e.code}): {body}")
+        sys.exit(1)
+
+    print("Tokens received successfully.\n")
+    print(f"Access token:  {tokens['accessToken']}")
+    print(f"Refresh token: {tokens['refreshToken']}")
+    print(f"Expires in:    {tokens['expiresIn']} seconds")

ctrader_oauth_fetcher-1.0.0/uv.lock

@@ -0,0 +1,8 @@
+version = 1
+revision = 3
+requires-python = ">=3.14"
+
+[[package]]
+name = "ctrader-oauth-fetcher"
+version = "0.1.0"
+source = { editable = "." }