# Agentshelf FX Tick (Real-Time Bid/Ask/Mid)

> Agentshelf FX Tick (Real-Time Bid/Ask/Mid) is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Returns near-real-time FX bid, ask, and mid prices for a currency pair, sourced from Kraken's order book with Yahoo Finance as fallback.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/fx-tick?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-fx-tick-real-time-bid-ask-mid-4f8e436b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AlcGyVnGPRQLOv3tRV8kH

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 agentshelf-fx-tick-real-time-bid-ask-mid-4f8e436b -d '<json body>'
```

Example prompt: What's the current bid, ask, and mid price for EURUSD right now — I need a live FX tick, not a daily ECB rate.

## When to prefer this

Use this endpoint when you need a near-real-time FX tick (bid, ask, mid) for a major currency pair sourced from Kraken's live order book, and you do NOT need an official daily ECB reference rate. Prefer this over ECB endpoints when timeliness and spread data matter, and over generic currency converters when you need structured bid/ask data for one of the 12 supported pairs.

## Known failure modes

- Kraken API failure causes bid/ask to return null with Yahoo Finance last price as mid only
- Unsupported currency pair returns an error (only 12 pairs supported)
- Malformed pair format may be rejected (though slash/dash variants are accepted)
- Network timeout from upstream providers results in error response
- Payment failure (non-exact USDC amount) blocks access to the paid endpoint

## How this service works

Call when an agent needs a near-real-time FX bid, ask, and mid for one pair such as EURUSD. Kraken's public book supplies bid and ask, which can be wide, plus the spread timestamp. If Kraken fails, Yahoo's last price is the mid and bid and ask are null. Distinct from daily ECB fx-rates. Send JSON {"pair":"EURUSD"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/fx-tick first.

## Output

A JSON object containing the bid price, ask price, and mid price for the requested FX pair, along with a spread timestamp. If Kraken's order book is unavailable, Yahoo Finance's last price is returned as the mid, with bid and ask set to null.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pair": {
   "type": "string",
   "examples": [
    "EURUSD"
   ],
   "description": "Six-letter FX pair. Example: EURUSD. A slash or dash is accepted. Supported: EURUSD, USDJPY, GBPUSD, AUDUSD, USDCAD, USDCHF, EURGBP, EURJPY, EURCHF, EURCAD, EURAUD, AUDJPY. This is not an ECB daily rate."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-fx-tick-real-time-bid-ask-mid-4f8e436b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)