> For the complete documentation index, see [llms.txt](https://minara.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minara.ai/docs/minara-handbook/ja/qu-yin/agent-api.md).
# API
Minara Agent APIは、標準HTTPインターフェースを通じて、開発者、トレーダー、市場アナリストがMinaraの金融インテリジェンスと取引執行に直接アクセスできるようにします。
{% hint style="warning" %}
APIキーへのアクセスには、 **Pro** プランのサブスクリプションが必要です。LiteおよびStarterプランでは、プロフィールのAPIタブにキー作成インターフェースの代わりにアップグレード案内が表示されます。x402経由の従量課金にはプラン要件はありません。
{% endhint %}
### APIでできること
暗号資産と株式のライブ市場データを取得できます: ウォレット活動、DeFi指標、オンチェーンのフロー、アルファシグナル。すべての応答はエージェントが利用しやすい形式で構造化されています。
市場コンテキストのクエリを送ると、すぐに実行できるプリセットの注文ペイロード付きでロングまたはショートの推奨が返ってきます。これにより、シグナルから取引までの流れが短縮されます。
取引内容を平易な英語で記述すると、APIは実行可能なオンチェーン取引トランザクションペイロードを返し、デフォルトでOKX DEXに対応しています。
予測市場におけるイベント結果のAI推定確率分布を、市場データ、ニュースコンテキスト、不確実性バンドに裏付けられて取得できます。割高・割安なオッズを見つけ、より明確なリスク境界でポジションサイズを決めるのに使えます。
### 仕組み
2つの請求方法：
1. Proプランで利用できるAPIキー。Minaraのプロフィールからキーを生成し、次の `Authorization` ヘッダーに含めます。
2. x402経由の従量課金 [x402プロトコル](https://www.x402.org/)。各リクエストはUSDCなどのステーブルコインで支払われます。プランのサブスクリプションは不要です。
### 始める
* [認証](/docs/minara-handbook/ja/qu-yin/agent-api/authentication.md): 各請求方法でリクエストがどのように認証されるか。
* [APIキー](/docs/minara-handbook/ja/qu-yin/agent-api/api-key.md): Proプランでキーを生成・管理します。
* [x402](/docs/minara-handbook/ja/qu-yin/agent-api/x402.md): ステーブルコインでリクエストごとに支払います。
* [APIリファレンス（APIキー）](/docs/minara-handbook/ja/qu-yin/agent-api/api-reference-api-key.md): APIキー方式の全エンドポイント仕様。
* [APIリファレンス（x402）](/docs/minara-handbook/ja/qu-yin/agent-api/api-reference-x402.md): x402方式の全エンドポイント仕様。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://minara.ai/docs/minara-handbook/ja/qu-yin/agent-api.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.