arthur-sdk 0.2.1__py3-none-any.whl

arthur_sdk-0.2.1.dist-info/METADATA

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: arthur-sdk
+Version: 0.2.1
+Summary: Simple trading for AI agents on Orderly Network
+Home-page: https://github.com/ranyi1115/arthur-sdk
+Author: Arthur
+Author-email: Arthur <arthur.orderly@proton.me>
+License: MIT
+Project-URL: Homepage, https://arthurdex.com
+Project-URL: Documentation, https://arthurdex.com/docs
+Project-URL: Repository, https://github.com/ranyi1115/arthur-sdk
+Project-URL: Issues, https://github.com/ranyi1115/arthur-sdk/issues
+Project-URL: Changelog, https://github.com/ranyi1115/arthur-sdk/blob/main/CHANGELOG.md
+Keywords: trading,crypto,orderly,defi,perpetuals,ai,agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pynacl>=1.5.0
+Provides-Extra: withdraw
+Requires-Dist: eth-account>=0.10.0; extra == "withdraw"
+Provides-Extra: all
+Requires-Dist: eth-account>=0.10.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: eth-account>=0.10.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Arthur SDK
+
+Simple trading for AI agents on [Orderly Network](https://orderly.network).
+
+Built for [Arthur DEX](https://arthurdex.com).
+
+## Installation
+
+```bash
+pip install arthur-sdk
+```
+
+For withdrawal support (requires wallet signing):
+```bash
+pip install arthur-sdk[withdraw]
+```
+
+## Quick Start
+
+```python
+from arthur_sdk import Arthur
+
+# Initialize client
+client = Arthur(
+    api_key="ed25519:...",
+    secret_key="ed25519:...",
+    account_id="0x..."
+)
+
+# Trade in one line
+client.buy("ETH", usd=100)   # Buy $100 of ETH
+client.sell("BTC", usd=50)   # Short $50 of BTC
+
+# Check positions
+for pos in client.positions():
+    print(f"{pos.symbol}: {pos.side} {pos.size} @ {pos.entry_price}")
+
+# Get account summary
+print(client.summary())
+```
+
+## Features
+
+### Trading
+```python
+# Market orders
+client.buy("ETH", usd=100)           # Buy $100 worth
+client.buy("ETH", size=0.1)          # Buy 0.1 ETH
+client.sell("BTC", usd=500)          # Short $500 worth
+
+# Limit orders
+client.limit_buy("ETH", price=3000, usd=100)
+client.limit_sell("ETH", price=4000, size=0.1)
+
+# Close positions
+client.close("ETH")                  # Close entire position
+client.close("ETH", size=0.05)       # Partial close
+client.close_all()                   # Close all positions
+
+# Cancel orders
+client.cancel_all()                  # Cancel all orders
+client.cancel_all("ETH")             # Cancel ETH orders only
+```
+
+### Account
+```python
+# Balances
+client.balance()           # Available USDC
+client.equity()            # Total equity (balance + unrealized PnL)
+client.free_collateral()   # Withdrawable amount
+
+# Positions
+client.positions()         # List all positions
+client.position("ETH")     # Get specific position
+client.pnl()               # Total unrealized PnL
+
+# Orders
+client.orders()            # List recent orders
+```
+
+### Withdrawal (New in 0.2.1)
+```python
+# Withdraw to wallet
+result = client.withdraw(
+    amount=100,
+    wallet_private_key="0x...",
+    chain_id=42161,  # Arbitrum
+)
+print(f"Withdrawal ID: {result['withdraw_id']}")
+
+# Withdraw all available
+result = client.withdraw_all(wallet_private_key="0x...")
+
+# Settle PnL before withdrawing
+client.settle_pnl()
+```
+
+### Market Data
+```python
+client.price("ETH")        # Current ETH price
+client.prices()            # All prices
+client.orderbook("ETH")    # Order book
+client.spread("ETH")       # Bid/ask spread
+```
+
+## Supported Symbols
+
+Short names: `BTC`, `ETH`, `SOL`, `ARB`, `OP`, `AVAX`, `LINK`, `DOGE`, `SUI`, `TIA`, `WOO`, `ORDER`
+
+Or use full Orderly symbols: `PERP_ETH_USDC`, `PERP_BTC_USDC`, etc.
+
+## Strategy Runner
+
+Run automated trading strategies:
+
+```python
+from arthur_sdk import StrategyRunner, StrategyConfig, Signal
+
+def my_strategy(client, config):
+    price = client.price("ETH")
+    # Your logic here
+    return Signal.HOLD
+
+config = StrategyConfig(
+    symbol="ETH",
+    usd_size=100,
+    interval_seconds=60,
+)
+
+runner = StrategyRunner(client, my_strategy, config)
+runner.run()
+```
+
+## Market Making
+
+```python
+from arthur_sdk import MarketMaker
+
+mm = MarketMaker(
+    client=client,
+    symbol="ETH",
+    spread_bps=10,        # 0.1% spread
+    order_size_usd=100,
+    num_levels=3,
+)
+mm.run()
+```
+
+## Configuration
+
+### From file
+```python
+client = Arthur.from_credentials_file("creds.json")
+```
+
+### Testnet
+```python
+client = Arthur(
+    api_key="...",
+    secret_key="...",
+    account_id="...",
+    testnet=True
+)
+```
+
+## Chain IDs
+
+| Chain | ID |
+|-------|-----|
+| Arbitrum | 42161 |
+| Base | 8453 |
+| Optimism | 10 |
+| Ethereum | 1 |
+
+## Links
+
+- [Arthur DEX](https://arthurdex.com)
+- [Orderly Network](https://orderly.network)
+- [API Documentation](https://docs-api.orderly.network)
+
+## License
+
+MIT

arthur_sdk-0.2.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+arthur_sdk/__init__.py,sha256=zkTM_nXHIvmU82pShrid_sfqB4cV3absfOFzzXlelig,809
+arthur_sdk/auth.py,sha256=b1gmnr-V4Liw9_gF4QQNZxfsKBAnYJ5BdBMrZFeUxsk,3664
+arthur_sdk/cli.py,sha256=GLDBJ5UodkNGb2iCFyhqZ--GxhjwPNjVYV9B4Re9TcU,6575
+arthur_sdk/client.py,sha256=RWmBZr_y1IPj-uns1xPz1rDjFXjfh7-6STZyytZjQxE,33374
+arthur_sdk/exceptions.py,sha256=S821SEqLZeIxYkx2H3eeSlbibECz_g51phiChrKdYs8,511
+arthur_sdk/market_maker.py,sha256=Q8lclEIoyfAswSXCRUBmWTcoriiHQc2xgbaoNEYwlLY,11250
+arthur_sdk/strategies.py,sha256=3lXgpvfatEKHM7OZuUj1nssdvcX5nzBw-U5ZDH2Xgyg,19212
+arthur_sdk-0.2.1.dist-info/licenses/LICENSE,sha256=8DZhA-icWyGv4_QUwfcI36Lm0mHlTNLqG4k8shiOph4,1063
+arthur_sdk-0.2.1.dist-info/METADATA,sha256=-wTnYJhVpIJaU24LrS-cSZgSkW4uHI__lbboiknoXEk,5367
+arthur_sdk-0.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+arthur_sdk-0.2.1.dist-info/entry_points.txt,sha256=6wEFeQwawLLRmJZRJswmN2GMOO39l9YsqV1uBwP2rGU,47
+arthur_sdk-0.2.1.dist-info/top_level.txt,sha256=Dp8_h8YrHYTZ5IUfhdNpC-LFVxu9FSoUqkWMo2VCV_c,11
+arthur_sdk-0.2.1.dist-info/RECORD,,

arthur_sdk-0.2.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

arthur_sdk-0.2.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+arthur = arthur_sdk.cli:main

arthur_sdk-0.2.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arthur
+
+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.

arthur_sdk-0.2.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+arthur_sdk