# Fxvault — convert

> Fxvault — convert is a paid API for AI agents from oraclepost.higgsfield.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-18).

Converts a specified amount of a crypto or fiat asset to USD using the live Chainlink oracle price feed on Base network.

## Facts

- Endpoint: GET https://oraclepost.higgsfield.app/api/premium/convert
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fxvault-convert-1bbfee87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N04wd39D2TXmz-ZoJ7Xrc

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 fxvault-convert-1bbfee87
```

Example prompt: Using the Chainlink oracle on Base, convert 1.5 ETH to USD and tell me the rate and how fresh the price data is.

## When to prefer this

Choose this endpoint when you need a real-time, oracle-sourced USD conversion for a specific crypto or EUR amount on Base network, especially when you need Chainlink provenance (feed ID and data age) for transparency or auditability. Prefer this over exchange-rate APIs when you specifically need the Chainlink oracle reference price rather than a market-aggregated tradable quote, and when working within the Base ecosystem.

## Known failure modes

- Unsupported asset ticker returns an error (only ETH, BTC, SOL, LINK, CBETH, AERO, EUR are supported)
- Invalid or non-numeric amount causes a bad request error
- Chainlink feed temporarily unavailable or stale data may return an error or aged timestamp
- Missing required query parameters (from or amount) returns a validation error
- Payment failure (x402) if USDC payment is not completed prior to response

## How this service works

Convert an amount of a crypto asset to USD using the live Chainlink price on Base. Pass ?from=ETH&amount=1.5 (assets: ETH, BTC, SOL, LINK, CBETH, AERO, EUR). Returns the rate used, the feed and its age. Oracle value, not a tradable quote. No cache.

## Output

Returns the USD equivalent of the requested amount, the exchange rate used, the specific Chainlink feed identifier on Base that was queried, and the age of the oracle data at request time. This is an oracle reference value, not a tradable quote, and is fetched fresh with no caching.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "amount"
     ],
     "properties": {
      "from": {
       "type": "string",
       "description": "Asset ticker, e.g. ETH, BTC, SOL, LINK, CBETH, AERO, EUR"
      },
      "amount": {
       "type": "string",
       "description": "Amount to convert, e.g. 1.5 (default 1)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fxvault-convert-1bbfee87/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oraclepost.higgsfield.app](https://www.zero.xyz/host/oraclepost.higgsfield.app/llms.txt)