# X-Rates Graph Data API

> Returns exchange rate trend data points for a currency pair for the current year, suitable for generating graphs. Each data point contains a month abbreviation label and that month's average rate value, in calendar order up to the current month. One page fetch per call; no pagination.

Source: https://www.sandbase.ai/apis/x-rates/graph-data
API reference: https://www.sandbase.ai/apis/x-rates/graph-data#api

## Facts

- Provider: X-Rates
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/x-rates/graph-data`
- Price: $0.03 per call
- Capabilities: api, x rates, finance, forex
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/x-rates/graph-data` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `to` | string | yes |  |
| `from` | string | yes | USD, EUR, GBP, JPY, CHF, CAD, AUD |
| `amount` | number | no |  |

## FAQ

### How do I use the X-Rates Graph Data API?

Send a POST request to https://api.sandbase.ai/v1/api/x-rates/graph-data with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the X-Rates Graph Data API cost?

$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the X-Rates Graph Data API accept?

Required: to (string) and from (one of USD, EUR, GBP, JPY, CHF, CAD, AUD). Optional: amount (number). The Parameters table and the Playground on this page list every field.

### What does the X-Rates Graph Data API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a X-Rates developer account or API key?

No. X-Rates Graph Data runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for X-Rates API access separately.

## README

### X-Rates Graph Data API

Returns exchange rate trend data points for a currency pair for the current year, suitable for generating graphs. Each data point contains a month abbreviation label and that month's average rate value, in calendar order up to the current month. One page fetch per call; no pagination.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "x-rates/graph-data", "to": "JPY", "from": "USD", "amount": 1.0}'
```

The result is returned in `outputs[0].data`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `from` | string | Yes | Source currency code (e.g. USD). One of: `USD`, `EUR`, `GBP`, `JPY`, `CHF`, `CAD`, `AUD`. |
| `to` | string | Yes | Target currency code (e.g. EUR). |
| `amount` | number | No | Amount to calculate rates for. |

#### Pricing

Flat $0.03 per call. Failed calls are not charged.