Fake fx rates API

28 fx rates from the Bank API, a fake banking API. Exchange rates against USD and the main crosses. The live stream ticks them.

Reads with filters, sorting, search and relations; writes that answer like a real server and stay in your session token. Same ids on every build. Free, no key, CORS open.

Connect

List: https://api.sondahub.com/v1/bank/fx_rates
One record: https://api.sondahub.com/v1/bank/fx_rates/{id}
OpenAPI 3: https://api.sondahub.com/v1/bank/openapi.json
GraphQL: https://api.sondahub.com/v1/bank/graphql
JSON file: https://api.sondahub.com/data/bank/fx_rates.json
MCP: https://api.sondahub.com/mcp · list_records

The first three fx rates

curl "https://api.sondahub.com/v1/bank/fx_rates?limit=3"

Sample records

Records 1 to 3 of 28, exactly as GET /v1/bank/fx_rates/{id} answers them. The data file holds all of them.

[
  {
    "id": 1,
    "created_at": "2026-09-01T12:00:00Z",
    "updated_at": "2026-09-01T12:00:00Z",
    "pair": "USD/EUR",
    "base": "USD",
    "quote": "EUR",
    "rate": 0.92,
    "bid": 0.9193,
    "ask": 0.9207,
    "change_24h_pct": 1.59,
    "as_of": "2026-09-01T12:00:00Z"
  },
  {
    "id": 2,
    "created_at": "2026-09-01T12:00:00Z",
    "updated_at": "2026-09-01T12:00:00Z",
    "pair": "USD/GBP",
    "base": "USD",
    "quote": "GBP",
    "rate": 0.78,
    "bid": 0.7794,
    "ask": 0.7806,
    "change_24h_pct": 0.92,
    "as_of": "2026-09-01T12:00:00Z"
  },
  {
    "id": 3,
    "created_at": "2026-09-01T12:00:00Z",
    "updated_at": "2026-09-01T12:00:00Z",
    "pair": "USD/ARS",
    "base": "USD",
    "quote": "ARS",
    "rate": 1320,
    "bid": 1318.94,
    "ask": 1321.06,
    "change_24h_pct": -0.31,
    "as_of": "2026-09-01T12:00:00Z"
  }
]

Fields

Field	Type	Notes
`id`read-only	int	Assigned by the server. Seed records keep their ids across restarts; records you create continue after the seed.
`created_at`read-only	datetime	When the record was created (ISO 8601, UTC).
`updated_at`read-only	datetime	When the record last changed.
`pair`required	string
`base`required	string
`quote`required	string
`rate`required	float
`bid`	float
`ask`	float
`change_24h_pct`	float
`as_of`	datetime

Endpoints

GET/v1/bank/fx_ratesA page, with every filter, sort, search, field and expand option.

POST/v1/bank/fx_ratesCreate one: 201 with the record, its id, a Location header and the session token that keeps it; 422 names each field that is wrong.

GET/v1/bank/fx_rates/{id}One record, with an ETag; If-None-Match earns a 304.

PATCH/v1/bank/fx_rates/{id}Change the fields you send.

PUT/v1/bank/fx_rates/{id}Replace the record; required fields must all be there.

DELETE/v1/bank/fx_rates/{id}Answers 200 with what was removed (a real server’s 204 lives at /v1/utils/status/204); gone for the session.

Try it

List with a filter

curl "https://api.sondahub.com/v1/bank/fx_rates?rate_gte=10&limit=3"

One record

curl https://api.sondahub.com/v1/bank/fx_rates/1

Create

curl -i -X POST https://api.sondahub.com/v1/bank/fx_rates \
  -H "Content-Type: application/json" \
  -d '{"pair":"USD/ARS","base":"USD","quote":"ARS","rate":9.99}'

Read it back: newest first (send the session token)

curl "https://api.sondahub.com/v1/bank/fx_rates?sort=-id&limit=3" \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Change one field

curl -X PATCH https://api.sondahub.com/v1/bank/fx_rates/1 \
  -H "Content-Type: application/json" \
  -d '{"rate":42.5}'

Delete the one you created

curl -X DELETE https://api.sondahub.com/v1/bank/fx_rates/29 \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Query recipes

Every list option works on fx rates; these are ready to paste. All the options.

What	Request
Page 2, 50 at a time (of 28)	/v1/bank/fx_rates?page=2&limit=50
Rate between two values, largest first	/v1/bank/fx_rates?rate_gte=1&rate_lte=500&sort=-rate
Newest first by created at	/v1/bank/fx_rates?sort=-created_at&limit=5
Pair contains “usd/eu”	/v1/bank/fx_rates?pair_like=usd%2Feu
Full-text search	/v1/bank/fx_rates?q=usd%2Feu
Only some fields	/v1/bank/fx_rates?fields=id,pair&limit=5
Just the count	/v1/bank/fx_rates?limit=1&fields=id

GraphQL

The same fx rates as the fx_rates query on https://api.sondahub.com/v1/bank/graphql, and one fx rate as fx_rate(id: 1). Introspection is on. More on the GraphQL API.

{
  fx_rates(limit: 3, sort: "-id") {
    total
    data {
      id pair base quote
    }
  }
}

Run it

curl https://api.sondahub.com/v1/bank/graphql -H "Content-Type: application/json" -d '{"query": "{ fx_rates(limit: 3, sort: \"-id\") { total data { id pair base quote } } }"}'

From an AI agent (MCP)

The MCP server reaches the same rows with list_records, get_record, create_record, update_record and delete_record, and as the resource sondahub://bank/fx_rates.

tools/call

curl https://api.sondahub.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_records","arguments":{"api":"bank","collection":"fx_rates","limit":3}}}'

More in the Bank API

customers (400) · accounts (640) · cards (505) · transactions (7,674) · transfers (800)

The live streams, and the whole API on one page: Bank API. Other worlds: fake e-commerce API, fake IoT API, fake social media API, fake helpdesk API, fake flight booking API, fake user directory API.