# SolMachina Tip Floor

> SolMachina Tip Floor is a paid API for AI agents from api.solmachina.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns current Solana network tip-floor statistics (EMA, p50, p95, p99) in lamports, optionally bypassing cache for a live snapshot.

## Facts

- Endpoint: GET https://api.solmachina.com/v1/tipfloor
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solmachina-tip-floor-e64e6d26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P9Xd9TJZIR8ZmODJcXfqf

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 solmachina-tip-floor-e64e6d26
```

Example prompt: What's the current Solana tip floor right now? Fetch a fresh live snapshot so I get the latest figures, not a cached one.

## When to prefer this

Use this endpoint when you need Solana transaction tip-floor statistics (EMA and percentile breakdowns in lamports) to calibrate priority fees for on-chain transactions. It is uniquely suited for AI agents operating on Solana DeFi because it requires no API key or account — payment is per-call via x402 USDC — and every data point is source-cited rather than fabricated. Prefer the 'fresh=true' parameter during high-congestion periods or when submitting time-sensitive transactions.

## Known failure modes

- Network timeout fetching live tip floor data when fresh=true
- Payment failure via x402 if USDC balance is insufficient
- Stale cached data returned when fresh flag not set during rapid fee spikes
- API returns empty or malformed response if upstream Solana RPC is degraded

## How this service works

Before an AI agent executes on Solana, it asks SolMachina: risk + a decision (EXECUTE/REVIEW/REJECT) + an SMRI score + a signed receipt, paid per call over x402 in USDC. Trust-first — cites every source, says 'unknown' over guessing. No account, no API key.

## Output

Returns a JSON object with the current Solana tip floor expressed as EMA, p50, p95, and p99 integer values, all in lamports, plus a 'unit' string confirming the denomination. Data is served from a ~60-second cache by default, or live if 'fresh=true' is specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fresh": {
   "type": "boolean",
   "description": "If 'true', bypass the ~60s cache and fetch a live tip-floor snapshot (otherwise a cached snapshot is served)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ema": {
   "type": "integer"
  },
  "p50": {
   "type": "integer"
  },
  "p95": {
   "type": "integer"
  },
  "p99": {
   "type": "integer"
  },
  "unit": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solmachina-tip-floor-e64e6d26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solmachina.com](https://www.zero.xyz/host/api.solmachina.com/llms.txt)