> ## Documentation Index
> Fetch the complete documentation index at: https://docs.infinite.net/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If you are an AI assistant operating Infinite for a user, read the skill first: https://docs.infinite.dev/agent-skill.md (setup per host, tool reference, rules for moving money, journeys).
> When operating Infinite for a user, use the MCP server. Sign in today at https://mcp.infinite.dev/mcp (Streamable HTTP, production) or legacy https://bot.api.infinite.dev/mcp — customer/BYO org members and returning Infinite Connect users; not https://connect.infinite.dev/mcp until Infinite announces Connect MCP is live. First-time Infinite Connect net-new onboarding is operator-assisted until then. After Infinite announces Connect MCP is live, customer/BYO org members keep the org URL; Infinite Connect users (net-new and returning Connect-only) sign in at https://connect.infinite.dev/mcp. Wrong URL may return API 403 codes (mcp_connect_url_required, mcp_org_url_required) or bot 401 when the token audience does not match the host; see https://docs.infinite.dev/guides/mcp.md. Send `Authorization: Bearer <key>` to https://mcp.infinite.dev/mcp/sse or legacy https://bot.api.infinite.dev/mcp/sse. Prefer MCP tools over raw HTTP; use REST only for steps no tool covers, and check `get_endpoint_schema` before guessing a request shape.
> Net-new Infinite Connect (org_connect): today use operator-assisted onboarding only (not self-serve Auth Kit net-new on the org MCP URL; not the shared platform org API key in personal MCP config). After Infinite announces Connect MCP is live, net-new users self-serve via Auth Kit at https://connect.infinite.dev/mcp with restricted Connect membership. BYO org keys onboard under that customer's org id. Connect sessions should show org_connect in get_organization_info.
> The key decides the tools. Every organization key (`sk_sandbox_…` / `sk_live_…`) gets docs, onboarding, `get_account_balance`, and request logs for your own organization. BYO organizations add payees an agent will pay with `create_payee` (payable once ACTIVE). Platform Connect sessions instead get bound-customer payment lookups (`get_quote`, `get_transfer`, `list_transfers`, `list_account_balances`), payee drafts (`create_payee_draft` / `get_payee_draft`; screening only, never payable), transfer drafts that wait for Infinite approval (`create_transfer_draft` / `get_transfer_draft`; never POST /v1/transfers), and with a bound customer, `create_transfer` (real POST /v1/transfers, forced IN_REVIEW until Infinite ops approve; not on BYO org keys). An agent key (`sk_sandbox_agent_…` / `sk_live_agent_…`) on a **PAYMENT**-role agent moves money within that agent's limits: `create_transfer` (draft) → `submit_transfer` → `wait_for_transfer`, without per-payment Infinite approval. **PAYMENT_OPERATIONS** agent keys are read-only (no `get_quote`, `create_transfer`, or `submit_transfer`; use `get_quote_by_id` and `list_transfers` on the pinned customer).
> On sandbox organization-key sessions, `sandbox_approve_customer` (makes the capabilities you pass READY, and related ones may turn READY too; `request_capabilities` is not needed), `sandbox_fund_account`, and `sandbox_complete_transfer` stand in for verification, funding, and settlement, so a whole flow runs from MCP. BYO org API keys may pass `customerId` on each call without binding. Platform Connect AuthKit: `create_business_customer` / `create_individual_customer` attempt to bind the session on success; if the response includes `bindError`, call `bind_session_customer` with the returned `continuationToken` before any other customer-scoped tool. OAuth rejects `X-Infinite-On-Behalf-Of` — use bind + `continuationToken` after create or reconnect. Platform org API keys may use `X-Infinite-On-Behalf-Of` to pin a customer.
> When searching documentation without a key, use the docs MCP at https://docs.infinite.dev/mcp.
> Start in sandbox (https://sandbox.api.infinite.dev). Do not use production unless the user explicitly asks.
> Confirm amount, currency, and payee with the user before any payment is submitted. Pass the invoice number as `reference` on `create_transfer`; the summary says what the payee will see.
> REST amounts are integer minor units (`"4000"` = 40.00 USD). MCP payment tools take exact decimal strings (`"40.00"`). Never mix them.
> Agent denials return `403 { denial: { code, message, window, limit, used, remaining, attemptedAmount, currency }, hint }` with decimal amounts; per-transfer denials omit `used` and `remaining`. Report them to the user; do not work around them.

# EUR Rate Locks

> Lock a USDC ↔ EUR exchange rate on a quote, then fund the transfer before the lock expires

## Overview

USDC → EUR payouts over SEPA and EUR → USDC deposits over SEPA Instant are priced from an indicative reference rate by default: the final amount is set when the funds arrive. When a rate lock is offered, you can hold a quote whose amounts are fixed. If the transfer is funded with the quoted amount before the lock expires, the quoted destination amount is what lands.

A locked rate is priced from an independent mid-market reference. Each locked quote reports that reference as `referenceRate`, `referenceRateAsOf` and `referenceProvider`.

## When a lock is offered

Request a quote as usual. `lockable: true` means you can hold the quote with a locked rate now. A lock is not always available. It depends on your configuration, the amount, the payment rail, current market conditions and available liquidity. When `lockable` is `false`, the quote stays indicative. Requesting a lock then returns `400` with the message `Exchange rates cannot be locked for this corridor. The rate is indicative until the transfer executes.`, and nothing is held.

| Direction | Pair | Rail | Lock window |
| - | - | - | - |
| Payout | USDC → EUR | SEPA, SEPA Instant | 15 minutes |
| Deposit | EUR → USDC | SEPA Instant, to the customer's named virtual account | 40 minutes |

A deposit lock needs the exact EUR amount you will send (`sourceAmount`), and cannot carry a fixed developer fee. A percentage developer fee is supported in both directions.

Near the Sunday market reopen, a lock may not be offered if its funding window would run past the reopen.

## Hold a locked quote

Request the quote with `holdQuote: true`, or quote a transfer intent with `lock: true`:

```bash theme={null}
curl -X POST https://api.infinite.dev/v1/quotes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "onBehalfOf": "cus_abc123",
    "sourceAmount": { "currency": "USDC", "rawValue": "1000000000" },
    "destinationCurrency": "EUR",
    "payinMethod": "BASE",
    "payoutMethod": "SEPA",
    "holdQuote": true
  }'
```

The response carries the lock:

```json theme={null}
{
  "id": "quote_abc123",
  "sourceAmount": { "currency": "USDC", "exponent": 6, "value": "1000000000", "displayValue": "1000.00" },
  "destinationAmount": { "currency": "EUR", "exponent": 2, "value": "85828", "displayValue": "858.28" },
  "exchangeRate": "0.000085828",
  "lockable": true,
  "referenceRate": "0.86",
  "referenceRateAsOf": "2026-11-18T11:59:00.000Z",
  "referenceProvider": "XE",
  "rateLock": {
    "status": "LOCKED",
    "expiresAt": "2026-11-18T12:15:00.000Z",
    "lockedSourceAmount": { "currency": "USDC", "exponent": 6, "value": "1000000000", "displayValue": "1000.00" },
    "lockedDestinationAmount": { "currency": "EUR", "exponent": 2, "value": "85828", "displayValue": "858.28" }
  }
}
```

`exchangeRate` is the all-in rate, in minor units, after the spread and any developer fee. `referenceRate` is the mid-market reference, in major units, that the lock was priced from.

## Create the transfer

Create the transfer from the quote with `confirm: true`. A locked quote cannot be used for a draft.

The deposit instructions must stay valid for at least four hours after `rateLock.expiresAt`. If you pass `expiresAt` on the transfer, it must be at or after that time; the default expiry already covers it.

Each awaiting-deposit transfer with a lock must have a unique deposit amount on its deposit account. If another transfer on the same account is already waiting for the same amount, creation is rejected. Change the amount by one minor unit, or wait until the other transfer is funded or expires.

## Fund before the lock expires

Send exactly `rateLock.lockedSourceAmount` before `rateLock.expiresAt`. Then `rateLock.status` moves from `LOCKED` to `SETTLED`, and `rateLock.lockedDestinationAmount` is what the recipient receives.

Funds that arrive up to four hours after `rateLock.expiresAt` still get the locked rate, as long as the market has not moved past the lock limit since the quote. Otherwise the lock is voided as `EXPIRED` and the transfer settles at the market rate. Funds that arrive later than four hours after `rateLock.expiresAt` always settle at the market rate. Until the lock is settled or voided, `rateLock.status` stays `LOCKED`, even once `rateLock.expiresAt` has passed.

If the lock cannot apply, `rateLock.status` becomes `VOIDED`, the transfer settles at the market rate, and `rateLock.voidReason` says why:

| `voidReason` | Meaning |
| - | - |
| `EXPIRED` | The funds arrived more than four hours after `rateLock.expiresAt`, or within those four hours after the market moved past the lock limit, or never arrived. |
| `MARKET_MOVED` | The market moved beyond what the lock covers, so the transfer settled at the market rate. |
| `FUNDING_FAILED` | The funding could not be completed at the locked rate. |
| `AMOUNT_MISMATCH` | The amount received did not equal `lockedSourceAmount`. |
| `CANCELLED` | The transfer ended before it was funded, or support released the lock. |

Transfer responses and transfer webhooks carry the same `rateLock` object, so you can track it either way.


## Related topics

- [Quotes and Transfers](https://docs.infinite.net/guides/quotes-and-transfers.md)
- [Create a quote](https://docs.infinite.net/api-reference/quotes/create-a-quote.md)
- [Get a quote by ID](https://docs.infinite.net/api-reference/quotes/get-a-quote-by-id.md)
- [Get an indicative FX rate for a pair](https://docs.infinite.net/api-reference/fx/get-an-indicative-fx-rate-for-a-pair.md)
- [Quote a transfer intent](https://docs.infinite.net/api-reference/transfers/quote-a-transfer-intent.md)
