> 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/ko/trade/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 추정 확률 분포를 조회하세요. 이를 활용해 잘못 가격이 책정된 배당을 식별하고 더 명확한 위험 경계 안에서 포지션 규모를 정할 수 있습니다.
### 작동 방식
두 가지 결제 방식:
1. API 키는 Pro 플랜에서 사용할 수 있습니다. Minara 프로필에서 키를 생성한 뒤 `Authorization` 헤더에 포함합니다.
2. 다음을 통한 종량제 [x402 프로토콜](https://www.x402.org/)x402. 각 요청은 USDC 같은 스테이블코인으로 결제되며, 플랜 구독이 필요하지 않습니다.
### 시작하기
* [인증](/docs/minara-handbook/ko/trade/agent-api/authentication.md): 각 결제 방식에서 요청이 어떻게 인증되는지.
* [API 키](/docs/minara-handbook/ko/trade/agent-api/api-key.md): Pro 플랜에서 키를 생성하고 관리합니다.
* [x402](/docs/minara-handbook/ko/trade/agent-api/x402.md): 스테이블코인으로 요청당 결제합니다.
* [API 참조(API 키)](broken://pages/5bf79a6466f04ab0bed65e0e6c3a947a15b3278b): API 키 흐름에 대한 전체 엔드포인트 사양.
* [API 참조(x402)](broken://pages/d17db36a61e7f05a28fbf1fe00fe7a0742f2f41f): 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:
```
GET https://minara.ai/docs/minara-handbook/ko/trade/agent-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.