{"id":26814600,"url":"https://github.com/iteralabs/traderman","last_synced_at":"2025-04-23T18:21:11.575Z","repository":{"id":245017311,"uuid":"816972684","full_name":"IteraLabs/traderman","owner":"IteraLabs","description":"Python SDK to build, train, stress-test, deploy and monitor trading strategies with an agentic approach","archived":false,"fork":false,"pushed_at":"2024-08-04T03:59:22.000Z","size":110,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T02:16:18.965Z","etag":null,"topics":["cryptocurrency","pytorch","trading"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IteraLabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-18T18:51:40.000Z","updated_at":"2025-01-21T20:22:01.000Z","dependencies_parsed_at":"2024-06-28T01:39:18.836Z","dependency_job_id":"6599a28b-78b9-43b1-b3b8-42ed91740c01","html_url":"https://github.com/IteraLabs/traderman","commit_stats":null,"previous_names":["iteralabs/traderman"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IteraLabs%2Ftraderman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IteraLabs%2Ftraderman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IteraLabs%2Ftraderman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IteraLabs%2Ftraderman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IteraLabs","download_url":"https://codeload.github.com/IteraLabs/traderman/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250487643,"owners_count":21438629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency","pytorch","trading"],"created_at":"2025-03-30T02:16:22.141Z","updated_at":"2025-04-23T18:21:11.377Z","avatar_url":"https://github.com/IteraLabs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Traderman\nPython SDK to build, train, stress-test, deploy and monitor trading strategies\n\n[![version](https://badge.fury.io/py/traderman.svg)](https://pypi.org/project/traderman)\n[![stars](https://img.shields.io/github/stars/iteralabs/traderman)](https://github.com/iteralabs/traderman/stargazers)\n[![issues](https://img.shields.io/github/issues/iteralabs/traderman)](https://github.com/iteralabs/traderman/issues)\n[![forks](https://img.shields.io/github/forks/iteralabs/traderman)](https://github.com/iteralabs/traderman/network/members)\n[![python](https://img.shields.io/badge/-Python_3.11-blue?logo=python\u0026logoColor=white)](https://www.python.org/downloads/release/python-3110/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)](https://github.com/iteralabs/tradernab/blob/master/.pre-commit-config.yaml)\n[![License](https://img.shields.io/github/license/iteralabs/traderman)](https://github.com/iteralabs/traderman/blob/master/LICENSE)\n\u003cbr\u003e\n\n\n## Install\n\nUsing `pip`\n\n```\npip install traderman\n```\n\nCloning the repository\n\n```\ngit clone https://github.com/iteralabs/traderman.git\n```\n\n\u003cbr\u003e\n\n## Use\n\n### Credentials\n\nOne alternative way of storing the Tokens is to place them in a .py inside a local virtual environment folder that is ignored (indicated in .gitignore) and run such\nfile once every working session that you are developing locally.\n\n\n```python\n\nimport os\nimport toml\nimport numpy as np\n\nfrom traderman.forecasters.benchmarks import Randomizer\nfrom traderman.connectors import binance as BinanceSpot\n\nBINANCE_API_KEY = os.environ[\"BINANCE_API_KEY\"]\nBINANCE_SECRET_KEY = os.environ[\"BINANCE_SECRET_KEY\"]\n\n# --- Get params from Config.toml\n\nwith open(cwd_path + \"/examples/basic_config.toml\", \"r\") as file:\n    config_data = toml.load(file)\n\nSET_SEED = config_data[\"model\"][\"signal\"][\"model_params\"][\"seed\"]\nSET_CLASSES = config_data[\"model\"][\"signal\"][\"model_params\"][\"classes\"]\n\n# --- Use the randomizer as model benchmark\n\nModelSignal = Randomizer(seed=SET_SEED, model_type=\"classifier\")\nforecasted_signal = ModelSignal.predict(classes=SET_CLASSES)\n\nModelRisk = Randomizer(seed=SET_SEED, model_type=\"regressor\")\nforecasted_volume = np.round(ModelRisk.predict(lower=0.0001, upper=0.0009), 4)\n\n# --- Specify parameters for trades\n\ntrade_params = {\n    \"symbol\": \"BTCUSDT\",\n    \"type\": \"MARKET\",\n    \"side\": forecasted_signal,\n    \"quantity\": forecasted_volume[0],\n}\n\n# --- Place an Order\n\nn_order = BinanceSpot.new_order(\n    in_params=trade_params,\n    api_key=BINANCE_API_KEY,\n    secret_key=BINANCE_SECRET_KEY\n)\n\n```\n\n\u003cbr\u003e\n\n## Contributors\n\nThanks to everyone that have contributed and made a difference.\n\n\u003ca href=\"https://github.com/iteralabs/traderman/graphs/contributors\"\u003e\n  \u003cimg class=\"dark-light\" src=\"https://contrib.rocks/image?repo=iteralabs/traderman\u0026anon=0\u0026columns=20\u0026max=100\u0026r=true\" /\u003e\n\u003c/a\u003e\n\nCheck out the following ways to contribute:\n\n- Check the [Contributing guide](https://github.com/IteraLabs/traderman/blob/main/CONTRIBUTING.md) and the [Open Projects](https://github.com/IteraLabs/traderman/projects?query=is%3Aopen)\n\n## Maintainers\n\n- [IFFranciscoME](https://github.com/IFFranciscoME)\n\n## References\n\n- [binance-docs/spot](https://binance-docs.github.io/apidocs/spot/en/#introduction)\n\n## License\n\n```\nMIT License\n\nCopyright (c) 2024 IteraLabs\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiteralabs%2Ftraderman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiteralabs%2Ftraderman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiteralabs%2Ftraderman/lists"}