How to place an order from a program on dYdX / プログラムからdYdXに注文を出す方法

dYdX is a decentralized exchange on Ethereum L2. Interesting thing is that they have order books.

I'm interested in dYdX for a while and finally started using it few weeks ago. dYdX announced zero fee up to $100,000 every month.

Free Trading - dYdX blog

Zero fee 🎉 It is a good chance to run a program for trading.

Although CCXT (CryptoCurrency eXchange Trading Library) is not ready yet for dYdX, there is a python library maintained by Brendan Chou, chief architect of dYdX.

dydx-v3-python · PyPI

As dYdX is mainly a set of smartcontracts on StarkEx and an account is a wallet, it's a bit different from interacting with centralize exchange APIs. Especially the signing part.

There is a rough overview how can we use the Python client on PyPI page above and there are some examples on GitHub.

dydx-v3-python/examples at master · dydxprotocol/dydx-v3-python

It took few days to figure out all the details such as what is host, what is web3_provider (an Ethereum node. I use Infura instead of running my own node) etc ... And the sample code to place an order had some parts to modify.

Moreover, I could get my account info and order info with API Key but I couldn't sign order requests with a set of Stark Keys generated with the client ... Luckily kind person helped me and I could finally place an order. His/her suggestion was to try with other account. It worked for me.

I copy paste my code (that works at least now in my environment) for someone who wants to trade on dYdX from a program.

import time
from dydx3 import Client
from dydx3.constants import API_HOST_MAINNET
from dydx3.constants import NETWORK_ID_MAINNET
from web3 import Web3
from dydx3.constants import MARKET_BTC_USD
from dydx3.constants import ORDER_SIDE_BUY
from dydx3.constants import ORDER_STATUS_OPEN
from dydx3.constants import ORDER_TYPE_LIMIT
from dydx3.constants import ORDER_TYPE_MARKET

WEB_PROVIDER_URL = "https://mainnet.infura.io/v3/xxxxxx"
eth_address = "<Your ethereum address"
eth_private_key = "<Private key for the address above. You can find it on Metamask."

client = Client(
    network_id=NETWORK_ID_MAINNET,
    host=API_HOST_MAINNET,
    default_ethereum_address=eth_address,
    eth_private_key=eth_private_key,
    web3=Web3(Web3.HTTPProvider(WEB_PROVIDER_URL)),
)

stark_key = client.onboarding.derive_stark_key()
api_key = client.onboarding.recover_default_api_key_credentials(eth_address)

private_client_with_key = Client(
    host=API_HOST_MAINNET,
    default_ethereum_address=eth_address,
    api_key_credentials=api_key,
    stark_private_key=stark_key['private_key'],
)

account_response = private_client_with_key.private.get_account()
position_id = account_response.data['account']['positionId']
print(position_id)

print(client.private.get_orders().data)

order_response=private_client_with_key.private.create_order(
    position_id=position_id,
    market=MARKET_BTC_USD,
    side=ORDER_SIDE_BUY,
    order_type=ORDER_TYPE_LIMIT,
    post_only=True,
    size='0.001',
    price='<16000 or some price far blow the current price>',
    limit_fee='0.001',
    expiration_epoch_seconds=time.time() + 100,
)                                              

print(order_response.data)

I wish you will see your order placed :)

If you get "Invalid signature for order" error, think about trying with other account. Setting up a new account costs though ... I had stuck with this error and all of a sudden I could make a signature with a new account with the same code just by changing Ethereum address and private key.

That's it. Happy coding & trading!

---

春くらいにdYdXに興味を持って、おもしろそうだなあと眺めていたのですが、ガス代が安くなったのと記事を書けることになったのをきっかけに少し前に使い始めました。

dYdX – オーダーブックを使える分散型取引所 | Gaiax Blockchain Bix

先日手数料無料（月額取引量$10万ドルまで）との発表があって、あ、これはプログラムから使いたい！と。

CCXTは対応していないのですが、dYdXのチーフアーキテクトの方がPythonのクライアントを作っていて、PyPIで公開されています。ただ、PyPIのページにある説明やGithubのサンプルを読み解くのには骨が折れました・・・。Githubのコードは半年ほど前のものだからか、ちょっとちがわないかな？というところも。

• dydx-v3-python · PyPI
• dydx-v3-python/examples at master · dydxprotocol/dydx-v3-python

調べているとQiitaで日本語でこのクライアントの使い方を解説している人がいました。このページを読んで概要をつかめて、あと「Infuraを使えばいいのか！」というのも目から鱗でした。DEX 初心者です 😅

DYDX(DeFi)を使ってみる。 - Qiita

三つのページを行き来しながらコードを書いて、いざ実行すると、Stark KeyやAPI Keyができて、API Keyを使うアカウント情報や注文情報の取得はできたものの、注文を出そうとすると「Invalid signature for order」というエラーが出てしまいます。Stark Keyがうまくできていない？

GithubのIssueにも同じエラーで詰まっている人の投稿がありましたが、いい解決策は見当たらず。dYdXの日本語コミュニティーで質問してみると、アカウントを変えると署名できるかもとのことで、もう一つアカウントを作って試してみたらエラー出ず注文を出せました。変えたのってEthereumアドレスと対応する秘密鍵の部分だけなのだけど。。

2022年8月12日時点で動いているコードを上に貼り付けておきます。

さて、ようやくスタートラインに立てました。手数料無料でのシステムトレードを楽しみたいと思います。

（写真は子どもにボットって何なのか説明したら描いた絵です。お金を取り合って戦っているのそうだけど楽しそう w）