# Apiosk Gateway – ExchangeRate.host Execute

> Apiosk Gateway – ExchangeRate.host Execute is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Executes a pay-per-call request to the ExchangeRate.host API via the Apiosk x402 gateway, returning currency exchange rate data in exchange for $0.05 USDC on Base.

## Facts

- Endpoint: POST https://gateway.apiosk.com/exchangerate-host/execute
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apiosk-gateway-exchangerate-host-execute-27d5c5bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_higT4MzzuRIUu7phZyU1l

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 apiosk-gateway-exchangerate-host-execute-27d5c5bf -d '<json body>'
```

Example prompt: Can you look up the current exchange rate from USD to EUR using ExchangeRate.host, and tell me how many euros I'd get for $250?

## When to prefer this

Choose this endpoint when you need programmatic access to ExchangeRate.host currency data and are already operating in a crypto-native, x402-compatible payment environment using USDC on Base. It is ideal for agents that need to pay per call without API key management, and when you want exchange rate lookups bundled with transparent on-chain cost accounting via the cost field in the response.

## Known failure modes

- Invalid operation selector returns an error status with no result
- Malformed JSON in the input field causes a bad request response
- Unsupported or misspelled currency codes result in upstream errors propagated in the result
- Payment failure on x402 protocol blocks the call before it reaches the upstream API
- Upstream ExchangeRate.host downtime returns a non-200 upstream_status code in the response

## How this service works

Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.

## Output

Returns a JSON object with a status string, the upstream ExchangeRate.host response body (containing rate data, converted amounts, or historical rates), the operation performed, latency in milliseconds, and the cost of the call in USDC.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "description": "JSON payload forwarded to the selected operation."
  },
  "operation": {
   "type": "string",
   "description": "Operation id, /path, or METHOD /path selector."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "result"
 ],
 "properties": {
  "api": {
   "type": "string"
  },
  "cost": {
   "type": "string"
  },
  "result": {
   "description": "Upstream response body."
  },
  "status": {
   "type": "string"
  },
  "latency": {
   "type": "number"
  },
  "operation": {
   "type": "string"
  },
  "upstream_status": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apiosk-gateway-exchangerate-host-execute-27d5c5bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)