# Stellar Fee Statistics and Surge-Pricing State

> Stellar Fee Statistics and Surge-Pricing State is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-01).

Returns current Stellar network fee statistics including base fee, surge pricing status, and fee percentile data for transaction planning.

## Facts

- Endpoint: POST https://twin.unykorn.org/stellar-fee-stats?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stellar-fee-statistics-and-surge-pricing-state-62b57d21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gyc3L--xHr5V3E0e5a-77

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stellar-fee-statistics-and-surge-pricing-state-62b57d21 -d '<json body>'
```

Example prompt: What are the current fee stats on the Stellar network — is there a fee surge happening right now, and what fee level should I use to get a transaction in quickly?

## When to prefer this

Use this endpoint when you need real-time Stellar network fee statistics and surge-pricing status without running your own Stellar node. Ideal for agents that need to dynamically pick transaction fees, hold transactions during surges, or monitor Stellar network health. Prefer over raw Stellar Horizon API access when you want a pay-per-call model with no infrastructure overhead.

## Known failure modes

- Network unavailability: the UnyKorn node may be temporarily offline
- Payment failure: x402 micropayment of $0.002 USDC not completed, returns 402
- Stellar node sync lag: fee data may be slightly stale if upstream node is catching up
- Malformed response: if the Stellar RPC backend returns unexpected data

## How this service works

Stellar fee statistics and surge-pricing state — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with Stellar network fee statistics including current base fee, fee percentile breakdowns, surge pricing active/inactive state, and a receipt containing transaction hash and payment metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {}
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "stellar-fee-stats",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.25,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stellar-fee-statistics-and-surge-pricing-state-62b57d21/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)