> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Solana 우선 수수료 API: 스마트 거래 수수료 추정

> Solana 거래에 대한 최적의 우선 수수료 추정. 실시간 수수료 분석을 통해 빠른 확인과 비용 효율성을 보장하는 6가지 우선 수준 제공.

<Info>
  **비용 절감, 성능 향상**: 실시간 네트워크 상태에 기반한 정확한 우선 수수료 추정을 받으세요. 원하는 속도에 필요한 만큼만 지불하십시오.
</Info>

## 우선 수수료란 무엇인가?

Solana에서는 우선 수수료를 통해 네트워크 혼잡 시 검증자 대기열에서 거래가 앞서갈 수 있습니다. 이것을 거래의 고속 차선이라고 생각하십시오.

<CardGroup cols={2}>
  <Card title="기본 수수료 vs 우선 수수료" icon="coins">
    **기본 수수료**는 거래 처리의 고정 비용입니다.

    **우선 수수료**는 더 빠른 처리를 위한 선택적 지불입니다.
  </Card>

  <Card title="작동 방식" icon="rocket">
    계산 단위당 가격을 설정합니다 - 높은 가격은 네트워크 혼잡 시 먼저 처리됩니다.
  </Card>
</CardGroup>

## 우선 수수료를 사용하는 이유

우선 수수료는 이제 Solana 거래의 표준 부분으로, 신뢰성 있는 확인 시간과 최적의 네트워크 성능을 보장합니다.

<CardGroup cols={2}>
  <Card title="신뢰할 수 있는 확인" icon="circle-check">
    다양한 네트워크 상태에서도 거래가 빠르고 신뢰성 있게 확인되도록 보장합니다.
  </Card>

  <Card title="경쟁 우위" icon="trophy">
    거래, 민팅, DeFi 상호작용처럼 시간에 민감한 운영에서 경쟁력을 유지합니다.
  </Card>

  <Card title="사용자 경험" icon="heart">
    더 나은 사용자 경험을 위해 일관적이고 빠른 거래 처리를 제공합니다.
  </Card>

  <Card title="네트워크 효율" icon="gauge">
    네트워크 자원 할당과 전반적인 성능 최적화를 돕습니다.
  </Card>
</CardGroup>

## 우선 수준의 설명

우리의 API는 최근 네트워크 활동에 기반한 여섯 가지 우선 수준을 제공합니다:

<AccordionGroup>
  <Accordion title="최소">
    **최저 관찰된 수수료** - 최근 슬롯에서 본 최소 수수료에 기반합니다.

    **적합한 경우**: 비용 최적화가 우선인 비긴급 거래

    **참고**: 확인 시간이 느려질 수 있습니다.
  </Accordion>

  <Accordion title="낮음">
    **25백분위** - 예산 친화적인 옵션으로 적당한 확인 시간을 제공합니다.

    **적합한 경우**: 속도가 중요하지 않은 표준 작업

    **참고**: 비용과 신뢰성의 좋은 균형 제공
  </Accordion>

  <Accordion title="중간(추천)">
    **50백분위** - 신뢰성 있는 확인 시간을 제공하는 중간 수수료

    **적합한 경우**: 대부분의 애플리케이션 및 일반적인 사용 사례

    **참고**: 대부분의 개발자에게 추천 시작점
  </Accordion>

  <Accordion title="높음">
    **75백분위** - 더 빠른 처리를 위한 높은 수수료

    **적합한 경우**: 시간에 민감한 작업 및 경쟁적 시나리오

    **참고**: 네트워크 활동시 우선 처리
  </Accordion>

  <Accordion title="매우 높음">
    **95백분위** - 최대 속도를 위한 프리미엄 수수료

    **적합한 경우**: 중요한 작업, MEV 전략, 긴급 거래

    **참고**: 높은 네트워크 활동 시에도 빠른 확인
  </Accordion>

  <Accordion title="안전하지 않은 최대">
    **최대 관찰** - 최근 슬롯에서 본 가장 높은 수수료

    **적합한 경우**: 긴급 상황 시에만 사용

    **경고**: 종종 불필요하게 높으므로 주의하여 사용하십시오.
  </Accordion>
</AccordionGroup>

<Warning>
  **비용 계산**: 총 우선 수수료 = 계산 단위당 가격 × 소비된 계산 단위 수

  일반적인 거래는 200,000-400,000 계산 단위를 사용합니다. 현재 중간 수준 (\~40,000 마이크로램포트 단위당)에서는 우선 수수료가 약 0.000008-0.000016 SOL입니다. 정확한 추정을 위해 항상 현재 네트워크 상태를 확인하십시오.
</Warning>

## 구현 방법

<CardGroup cols={2}>
  <Card title="직렬화된 거래 (추천)" icon="file-code" href="/docs/ko/priority-fee/estimating-fees-using-serialized-transaction">
    **주요 방법** - 최대 정확도를 위해 정확한 거래를 분석합니다.

    **적합한 경우**: 대부분의 애플리케이션 및 생산 사용 사례

    **이점**:

    * 명령별 분석
    * 최고의 정확도
    * 생산 준비 완료
    * 거래 복잡성 고려
  </Card>

  <Card title="계정 키 (고급)" icon="key" href="/docs/ko/priority-fee/estimating-fees-using-account-keys">
    **특수 사용 사례** - 계정 패턴에 기반한 추정

    **적합한 경우**: 사전 거래 분석, 일괄 작업, 특수 아키텍처

    **이점**:

    * 계정 수준 패턴 분석
    * 계획 및 연구에 유용
    * 일괄 계정 분석
  </Card>
</CardGroup>

## 빠른 시작 예제

<CodeGroup>
  ```javascript JavaScript theme={"system"}
  import { Transaction, SystemProgram, ComputeBudgetProgram } from "@solana/web3.js";
  import bs58 from "bs58";

  // 1. Build your transaction (without priority fee)
  const transaction = new Transaction();
  const transferIx = SystemProgram.transfer({
    fromPubkey: senderKeypair.publicKey,
    toPubkey: recipientPublicKey,
    lamports: 1000000, // 0.001 SOL
  });
  transaction.add(transferIx);

  // 2. Set required fields and serialize
  transaction.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
  transaction.feePayer = senderKeypair.publicKey;
  const serializedTx = bs58.encode(transaction.serialize());

  // 3. Get priority fee estimate
  const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: "1",
      method: "getPriorityFeeEstimate",
      params: [{
        transaction: serializedTx,
        options: { 
          priorityLevel: "Medium",
          recommended: true 
        }
      }]
    })
  });

  const result = await response.json();
  const priorityFee = result.result.priorityFeeEstimate;

  // 4. Add priority fee and send
  transaction.instructions = []; // Reset
  transaction.add(ComputeBudgetProgram.setComputeUnitPrice({ microLamports: priorityFee }));
  transaction.add(transferIx);
  transaction.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
  transaction.sign(senderKeypair);
  ```

  ```python Python theme={"system"}
  import requests
  import base58
  from solana.transaction import Transaction
  from solana.system_program import transfer, TransferParams

  # 1. Build and serialize your transaction
  # (transaction building code here)
  serialized_tx = base58.b58encode(transaction.serialize()).decode('utf-8')

  # 2. Get priority fee estimate
  response = requests.post(
      "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY",
      json={
          "jsonrpc": "2.0",
          "id": "1",
          "method": "getPriorityFeeEstimate",
          "params": [{
              "transaction": serialized_tx,
              "options": {
                  "priorityLevel": "Medium",
                  "recommended": True
              }
          }]
      }
  )

  result = response.json()
  priority_fee = result["result"]["priorityFeeEstimate"]
  print(f"Recommended priority fee: {priority_fee} micro-lamports")

  # 3. Rebuild transaction with priority fee and send
  ```

  ```curl cURL theme={"system"}
  curl -X POST "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": "1",
      "method": "getPriorityFeeEstimate",
      "params": [{
        "transaction": "SERIALIZED_TRANSACTION_BASE58",
        "options": {
          "priorityLevel": "Medium",
          "recommended": true
        }
      }]
    }'
  ```
</CodeGroup>

## API 참조

<Card title="getPriorityFeeEstimate" icon="code" href="/docs/ko/api-reference/priority-fee/getpriorityfeeestimate">
  모든 매개변수와 응답 형식이 포함된 전체 API 문서
</Card>

## 실시간 네트워크 모니터링

<Tip>
  **전문가 팁**: 네트워크 상태를 모니터링하여 우선 수수료 전략을 최적화하세요. 정상 상태에서는 낮은 우선 수준을 사용하세요. 혼잡 시, 시간에 민감한 작업을 위해 높은 수준을 고려하십시오.

  현재 네트워크 상태는 Solana 탐색기 또는 `getRecentPerformanceSamples` RPC 메소드를 사용하여 확인할 수 있습니다.
</Tip>

## 지원 및 리소스

<CardGroup cols={2}>
  <Card title="디스코드 커뮤니티" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    커뮤니티 및 Helius 팀의 도움을 받으세요
  </Card>

  <Card title="직접 지원" icon="headset" href="/docs/ko/support">
    우선 수수료 질문 및 최적화 지원
  </Card>
</CardGroup>