X-Rates Monthly Average

Name: X-Rates Monthly Average
Price: 0.03 USD
Availability: InStock
Author: X-Rates

https://api.sandbase.ai/v1/api/x-rates/monthly-average

Retrieves monthly average exchange rates for a specific currency pair for a given year. Returns up to 12 monthly data points with the average rate and number of days in each month. Defaults to the current year if year is not specified.

Price: $0.03USD / call
Method: POST
Response: JSON
Parameters: 2 required · 2 optional

Input

To(string)

Target currency code (e.g. EUR).

From(string)

Source currency code (e.g. USD).

Year(string)

Year in YYYY format. Defaults to the current year.

Amount(number)

Amount to calculate rates for.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

API README

X-Rates Monthly Average API

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "x-rates/monthly-average", "to": "JPY", "from": "USD", "year": "2024", "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.
`year`	string	No	Year in YYYY format. Defaults to the current year.

Pricing

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

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/x-rates/monthly-average

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/x-rates/monthly-average" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "to": "JPY",
  "from": "USD",
  "year": "2024",
  "amount": 1
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

`to`stringrequired

Target currency code (e.g. EUR).

`from`stringrequired

Source currency code (e.g. USD).

Possible values: USD, EUR, GBP, JPY, CHF, CAD, AUD

`year`string

Year in YYYY format. Defaults to the current year.

`amount`number

Amount to calculate rates for.

Default: 1

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.

Explore more

Related APIs

All APIs

API	Price	Response
X-Rates Monthly AverageThis API `X-Rates`	$0.03 per call	JSON
X-Rates 24H Percent Changes `X-Rates`	$0.03 per call	JSON
X-Rates Convert Currency `X-Rates`	$0.03 per call	JSON
X-Rates Current Rates Table `X-Rates`	$0.03 per call	JSON
X-Rates Graph Data `X-Rates`	$0.03 per call	JSON
X-Rates Historical Rates Table `X-Rates`	$0.03 per call	JSON

Questions

FAQ

How do I use the X-Rates Monthly Average API?

Send a POST request to https://api.sandbase.ai/v1/api/x-rates/monthly-average 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 Monthly Average 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 Monthly Average API accept?

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

What does the X-Rates Monthly Average 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 Monthly Average 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.