スタートガイド
0x APIスイートは、アプリ内でより高速な取引、より良い価格、優れたUXを実現する最もシンプルな方法です。開始するには、0x Dashboard にアクセスするためのアカウントを設定し、APIキーを生成、統合を監視・管理し、新しいAPIへのアクセスやデベロッパーリソースを活用する必要があります。
以下のステップを実行すれば、5分以内で開始できます。
1. 0xアカウントを作成する
0x Dashboard でアカウントを作成するには、Sign Up をクリックし、名前、メールアドレス、パスワードを入力し、Continue をクリックします。
2. チームを作成する
確認後、チームを作成するよう求められます。チーム名を決め、構築しているプロジェクトのタイプを選択します。このアカウントはチームメイトと共有できます。
3. ダッシュボードを見て回る
3.1 テストAPIキー
チーム作成後、0x Dashboard に移動し、ライブAPIキーの作成・管理、ビルドリソースの検索、サポートリクエストの提出ができます。
0xがサポートするすべてのネットワークのリストは、0x Cheat Sheet をご覧ください。
ダッシュボードには、サンプルリクエストに使用できるテストAPIキーが付属しています。curlリクエストにプラグインしてCLIから実行し、ライブSwap APIの見積もりリクエストを確認してみてください。
// ヘッダーのAPIキーをサンプルキーに置き換えてください
curl --location --request GET 'https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber' --header '0x-api-key: [api-key]'
3.2 アプリを作成する
Create an app をクリックして、複数の0xプロダクトにアクセスできるライブAPIキーを取得します。
ポップアップから、アプリ名と、このAPIキーで有効にする0xプロダクト(Swap API、Orderbook API)を入力し、Continue をクリックします。
Note: アプリ作成後でも、このキーで利用可能な0xプロダクトを更新できます。
3.3 0x Explorerタグを追加する
次の画面で、0x Explorer 上でアプリからのトランザクションデータを識別するためのユニークなタグを追加できます。すべてのアプリに同じタグを使用することも、アプリごとに個別のタグを作成することもできます。
0x Explorerは、0x APIを介してルーティングされたERC-20トランザクションに関するデータを提供します。これは、デベロッパーとユーザーがトランザクションを検証し、オンチェーンアクティビティを簡単かつ低摩擦で分析するための信頼性が高く透明性のあるツールです。
今はスキップして、後でタグを追加することもできます。
3.4 APIキーを表示する
最終画面でAPIキーをコピーします。このキーはユニークで、あなたのアプリに紐づいています。共有しないでください。必要に応じて、アプリ用の追加APIキーを作成することもできます。
APIキーを使用すると、0x上でリクエストを認証できます。リクエスト時に0x-api-keyヘッダーパラメータでキーを指定することを忘れないでください。
// ヘッダーのAPIキーを実際のキーに置き換えてください
curl --location --request GET 'https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber' --header '0x-api-key: [api-key]'
4. アプリを管理する
メインのダッシュボード画面から、作成したすべてのアプリを確認できます。
アプリをクリックすると、その詳細が開きます。
各アプリについて、以下を確認できます。
- APIキーで有効になっている0xプロダクト(Swap APIやOrderbook API)を確認できます。
- APIキー から、このアプリに関連するすべてのAPIキーを確認し、キーの作成や削除ができます。Settings から、このアプリで有効にする0xプロダクトを変更したり、0x Explorerタグ を設定したり、アプリ名 を変更できます。
- 0x Explorerタグ を設定している場合、このアプリに関連するオンチェーンデータとトランザクションを表示できます。
- ビルドリソース を表示できます。
5. アカウントを管理する
右上隅の アカウントアバター から、アカウントを管理するための追加設定を見つけることができます。
- Settings - 氏名、チーム名、アカウントのメールアドレスを確認したり、パスワードを変更できます。
- Contact Support - 質問がありますか?開発サポートチームに連絡してください。
- Docs - デベロッパードキュメント にアクセスして、構築を開始しましょう。
- Help - ヘルプが必要ですか?よくある質問とヘルプセンターをご確認ください。
- 0x Explorer - 0x Explorer タグを設定している場合、アプリのオンチェーンアクティビティとトランザクションを簡単に分析できます。0x Explorerタグについて詳しく見る
6. 質問がありますか?
0x Dashboardにログインしている場合、ダッシュボード右下のIntercom Messenger for Developer Supportを介して、チームに直接連絡できます。
7. 構築を始める
ライブAPIキーができたので、ビルドリソースに飛び込んで構築を始めましょう!
0x入門
TIP
代わりに動画をご覧になりたいですか? 0x Concept Videos をご覧ください。
0xとは?
0xは、暗号レール上で金融商品を構築するためのデベロッパー向けワンストップショップです。0xは数百のデベロッパーに不可欠なweb3ツールを提供し、より高速な取引、より良い価格、優れたUXを実現します。当社のAPIスイートは、Coinbase Wallet、Robinhood Wallet、Metamask、Zerion、Zapperなどで取引を行う600万人以上のユーザーから、5,200万件以上のトランザクションと1,250億ドルのボリュームを処理しています。
TIP
子どもにもわかる0x(5歳児に説明するように)
0xは、おもちゃやお菓子、シールなど、さまざまなものを交換できる大きな遊び場のようなものです。ただし、おもちゃやお菓子の代わりに、暗号通貨のようなデジタルなものを取引します。この遊び場には2種類の人々がいます。交換するものを持ってくる人(メイカーと呼びます)と、それらのものを交換したい人(テイカーと呼びます)。0xは、これらの人々がお互いを見つけ、安全かつ公正に取引できるように支援します。まるで、みんなが楽しく遊んでいるかどうかを見守る大人が遊び場にいるようなものです。
0xエコシステム
0xテクノロジースタック
0xのプロフェッショナルグレードのAPIは、セキュリティ監査済みの安全なスマートコントラクト群である0x Protocol 上に構築されています。これらのツール上に構築されたアプリケーションは、0x Ecosystemの一部です。
以下の図は、0x Ecosystemの概要を示しています。これには、流動性を供給するアプリケーション(メイカー)と流動性を需要するアプリケーション(テイカー)が含まれます。
メイカーとテイカー
0x Ecosystemには、メイカーとテイカーの2つの側面があります。
供給(別名メイカー)
これは、0xオーダー を作成し、需要側(テイカー)が消費するための流動性をシステムに提供するエンティティです。0xは、複数のソースからの流動性を集約します:
- オンチェーン流動性 - DEX、AMM(例:Uniswap、Curve、Bancor)
- オフチェーン流動性 - プロフェッショナルマーケットメイカー、0xのオープンオーダーブックネットワーク
- 関連ドキュメント:
- マーケットメイカー - 指値注文によるプロフェッショナルなマーケットメイキング
- Orderbook API - 指値注文の共有
- 指値注文(上級トレーダー向け) - 指値注文の执行と管理
需要(別名テイカー)
これは、メイカーの資産を欲するエンティティです。テイカーは自身の資産とメイカーの資産を交換することに同意します。つまり、0xの流動性を消費するのです。例として、MetaMask、Coinbase、dYdXなどのプロジェクトが挙げられます。
- 関連ドキュメント:
- Swap API - 単一のAPIを通じてERC20トークンのための最も効率的な流動性アグリゲーター。
0xはどのように機能するのか?
0xオーダーがどのように実行されるかを見てみましょう。
- メイカーが0xオーダーを作成します。これは、標準的なオーダーメッセージ形式に準拠したJSONオブジェクトです(すべての0xオーダータイプのリストはこちら)。これは、メイカーがどのような種類の資産を取引するかにコミットしているかを示します。資産には、代替可能トークン(ERC20)、非代替可能トークン(ERC721)、または資産のバンドル(ERC1155)が含まれます。
- オーダーはハッシュ化され、メイカーはオーダーに署名して、自分が作成したオーダーに暗号化コミットします。
- オーダーはカウンターパーティと共有されます。
- メイカーが希望するカウンターパーティをすでに知っている場合は、オーダーを直接送信できます(メール、チャット、OTCプラットフォーム経由)。
- メイカーが取引を受け入れてくれるカウンターパーティを知らない場合は、オーダーブックにオーダーを提出できます。
- 0x APIはすべての供給ソースから流動性を集約し、テイカーにとって最良の価格を提示します。0xは、オフチェーンリレーとオンチェーン決済というパラダイムを通じて、トレーダーが0xオーダーを作成、検索、履行できるように支援します。つまり、0xはオーダーをブロックチェーンに保存するのではなく、オーダーはオフチェーンに保存され、取引決済のみがオンチェーンで行われます。このユニークな特徴により、0xはデベロッパーが構築するための柔軟でガス効率の良いDEXプロトコルとなっています。
- テイカーは、オーダーとその履行量をブロックチェーンに提出することで、0xオーダーを履行します。
- 0x Protocolの決済ロジックは、メイカーのデジタル署名と取引のすべての条件が満たされていることを検証します。満たされている場合、関連する資産はメイカーとテイカーの間でアトミックスワップされます。満たされていない場合、取引は取り消されます。
0xで何を構築できるか?
以下は、0x上に構築されたプロジェクトの網羅的ではないリストです。0xは、交換がアプリケーションの中核目的ではない既存のアプリケーションにも統合できることに注意してください。詳細については、このブログ記事をご覧ください。
需要(テイカー)
-
取引所
- Y市場におけるX資産の分散型取引所
- デジタルグッズのEbayスタイルのマーケットプレイス
- 店頭(OTC)取引デスク
-
ウォレット
- ユーザーがトークンを交換したいデジタルウォレット
-
オプションとデリバティブプラットフォーム
- 機能するために流動性と交換を必要とするDeFiプロトコル(例:デリバティブ、レンディング、オプション)
-
ポートフォリオマネージャー
-
予測市場
-
非代替可能トークン(NFT)取引所
- NFTマーケットプレイス
- ゲーム内通貨やアイテムのあるゲーム
-
投資戦略(例:DeFiインデックスファンド、DCAアプリ)
-
データ
- 0xマルチチェーン分析ポータル
- GraphQLラッパーを使用したリアルタイム取引パネル
供給(メイカー)
- オーダーブックモデル
- 自動マーケットメイカー(AMM)モデル
- マーケットメイカー
- マーケットメイキングまたはアービトラージ取引ボット
ガイド
このページでは、ユースケースに基づいて0xを使い始めるための最も人気のあるガイドを紹介しています。
Swap API
単一のAPIでアプリに流動性集約を簡単に追加できます。Swap APIを使用すると、100以上の取引所と何千ものトークンにアクセスできます。
コード例
- (Next.js) 0x Demo App - 0x Swap API、Next.js、ConnectKitを使用したERC20スワップアプリの例
- (HTML, CSS, Javascript) 0x Demo App
- https://github.com/0xProject/0x-starter-project - 実行可能な例のコレクションを通じて0x v4プロトコルを紹介するプロジェクト
チュートリアル
- Swap APIの使用方法 - このガイドでは、プログラムでERC20トークン取引を実行する方法を学びます。
- Next.js、0x、ConnectKitでトークンスワップdAppを構築する - トークンスワップdAppを構築する際に重要なデベロッパーコンセプトをカバーするビデオチュートリアル。
- 0x APIでトークンスワップdAppを構築する方法 - Swap APIを使用したトークンスワップdApp(シンプルなMatcha.xyz)の構築方法に関する記事およびビデオコンテンツ。このdAppは、より広範なDEXエコシステム全体から流動性を集約し、ユーザーに最良の価格を提供します。
- スマートコントラクトで0x API流動性を使用する - このガイドでは、スマートコントラクト内から0x APIのスワップ見積もりを消費する方法を学びます。
- テストネットでの作業 - Goerliテストネットを使用する方法と、Ethereumメインネットを独自のテストネットにフォークする方法の2つで、0x APIを使用したERC20トークンのスワップをテストする方法を学びます。実行可能な例が含まれます。