# Marks Hedging API > Open and manage FX hedges for frontier-market currencies, programmatically. ## Docs - [Account Summary](https://docs.marks.finance/api-reference/account/account-summary.md): Returns your account summary: free balance, margin in use, total open exposure, unrealized P&L, and number of open positions. `balance_usdc` is your free, spendable balance; margin locked in open positions is counted separately. - [Open Positions](https://docs.marks.finance/api-reference/account/open-positions.md): Returns your open positions, aggregated per side (one line each for buy and sell). Each line shows entry and mark price, gross P&L (price only), accrued carry, net P&L (price plus carry), the fee to close, and net margin - what you'd reclaim if you closed now. - [Add to a Hedge](https://docs.marks.finance/api-reference/hedges/add-to-a-hedge.md): Increases your existing open hedge on a market+side by adding notional, **keeping the same maturity** - the convenience form for the desk, which knows the market and side but not the hedge id. Resolves the open hedge server-side. Returns `404 no_open_hedge` if you don't have one on that side (open o… - [Close a Hedge](https://docs.marks.finance/api-reference/hedges/close-a-hedge.md): Fully closes your open position on a market and side. Returns `submitted` with an `order_tx_hash`; it's filled shortly after, and `GET /positions` returns to flat once it drains. Pass an `Idempotency-Key` to make retries safe. - [Closed Hedge History](https://docs.marks.finance/api-reference/hedges/closed-hedge-history.md): Returns your closed hedges, newest first, with realized P&L, carry, and fees. Each record covers the full open-to-close lifecycle: entry and exit price, gross and net realized P&L, carry, and fees. - [Get a Hedge](https://docs.marks.finance/api-reference/hedges/get-a-hedge.md): Returns a single hedge by its id. Use this to poll for the fill after opening. Returns `404 hedge_not_found` if the id isn't one of yours. - [List Hedges](https://docs.marks.finance/api-reference/hedges/list-hedges.md): Lists your hedges, newest first. Filter with `?status=` and `?client_reference=`. - [Open a Hedge](https://docs.marks.finance/api-reference/hedges/open-a-hedge.md): Opens a hedge for the given market, side, size, and tenor. Returns immediately with status `submitted`, an `order_tx_hash`, and a `hedge_id`; it's filled shortly after, so poll `GET /hedges/{id}` for the fill. Pass a unique `Idempotency-Key` to make retries safe, and (for API keys) a `client_referen… - [Reduce a Hedge](https://docs.marks.finance/api-reference/hedges/reduce-a-hedge.md): Partially reduce your open hedge on a market and side by removing notional, keeping the same maturity - the mirror of `/hedges/add`. The reduction is proportional, so the margin backing the position scales down with it; if the reduction covers roughly the whole position, it closes fully. Returns `su… - [Introduction](https://docs.marks.finance/api-reference/introduction.md): Base URL, authentication, and response conventions for the Marks Partner API. - [Current Prices](https://docs.marks.finance/api-reference/market-data/current-prices.md): Current price for a market. - [List Available Markets](https://docs.marks.finance/api-reference/market-data/list-available-markets.md): Returns the markets available to you, each with its current status, rate, capacity per side, and daily carry rate. - [Request a Quote](https://docs.marks.finance/api-reference/quotes/request-a-quote.md): Returns an indicative price and full cost breakdown for a hedge. Specify the market, side, size, and tenor; the response covers execution price, carry (daily and over the tenor), and the upfront cost - required margin plus platform fee. Tenor must be 1, 3, or 7 days. Nothing is opened or persisted. - [Accounts & Team](https://docs.marks.finance/guides/accounts-and-team.md): One account per institution, shared by your team, with roles that control access. - [Add to a Hedge](https://docs.marks.finance/guides/add-to-a-hedge.md): Grow an open Hedge by adding notional, keeping the same maturity. - [API Conventions](https://docs.marks.finance/guides/api-conventions.md): Base URL, response envelope, amounts, idempotency, rate limits, and error codes shared across every endpoint. - [Authentication](https://docs.marks.finance/guides/authentication.md): How to authenticate every request with your API key. - [Close & Settle](https://docs.marks.finance/guides/close-and-settle.md): Close a Hedge early or let it settle at maturity, then review the outcome. - [Funding & Withdrawals](https://docs.marks.finance/guides/funding.md): How your account's USDC balance is funded and withdrawn. - [How Hedging Works](https://docs.marks.finance/guides/how-hedging-works.md): What a Hedge is, and how tenor, carry, margin, and settlement fit together. - [Stages & Statuses](https://docs.marks.finance/guides/lifecycle.md): The stages a Hedge moves through, and where each action lives. - [Monitor Positions](https://docs.marks.finance/guides/monitor-positions.md): Read a live Hedge's P&L, accrued carry, and margin. - [Open a Hedge](https://docs.marks.finance/guides/open-a-hedge.md): Price a Hedge, open it, and poll until it fills. - [Quickstart](https://docs.marks.finance/guides/quickstart.md): Open your first Hedge in a few minutes: quote, open, poll, and close. - [Reduce a Hedge](https://docs.marks.finance/guides/reduce-a-hedge.md): Remove notional from an open Hedge, keeping the same maturity. - [Sandbox](https://docs.marks.finance/guides/sandbox.md): Build and verify against test infrastructure before going live. - [Supported Markets](https://docs.marks.finance/guides/supported-markets.md): Which markets you can hedge today, and how to read market capacity and carry. - [Overview](https://docs.marks.finance/index.md): The Marks hedging API for payment companies and fintechs. ## OpenAPI Specs - [openapi](https://docs.marks.finance/api-reference/openapi.json)