# SolMachina Epoch Info

> SolMachina Epoch Info 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 the current Solana epoch number, slot index, total slots in epoch, and estimated time remaining until the epoch ends

## Facts

- Endpoint: GET https://api.solmachina.com/v1/epoch
- 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-epoch-info-f54cbd6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cd0l0nHpfQ-pXVMzYjrH2

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-epoch-info-f54cbd6a
```

Example prompt: What's the current Solana epoch, how many slots are left, and how many seconds until it ends? Use both slot-rate measures for the ETA.

## When to prefer this

Use this endpoint when you need real-time, sourced Solana epoch timing data without setting up an account or API key, and you want to pay per call via x402 USDC micropayments. Prefer it over raw RPC calls when you need a clean, structured response with dual slot-rate ETA estimates and you are operating as an autonomous AI agent in a trust-first DeFi context.

## Known failure modes

- Invalid 'rate' parameter value (not 'primary', 'alt', or 'both') returns a 400 error
- Payment failure or insufficient USDC balance returns a 402 Payment Required response
- Solana RPC node unavailability may cause 503 or delayed responses
- Stale slot data if the underlying RPC is lagging behind the canonical chain

## 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 epoch integer, the current slot index within that epoch, the total number of slots in the epoch, and the estimated seconds remaining until the epoch ends (computed from measured slot rates — primary, alt, or average of both depending on the 'rate' parameter).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rate": {
   "type": "string",
   "description": "Which measured slot-rate to use for the ETA: 'primary', 'alt', or 'both' (default)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "epoch": {
   "type": "integer"
  },
  "slotIndex": {
   "type": "integer"
  },
  "slotsInEpoch": {
   "type": "integer"
  },
  "etaSecondsToEnd": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solmachina-epoch-info-f54cbd6a/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)