# GET /v1/xrpl/account/{address}/offers

One page of an account's open DEX offers, with how funded each one is.

## Purpose

Returns one page of the account's open DEX offers from the validated ledger, in the ledger's order. Each offer has `seq` (the sequence number of the transaction that created it), `sells` (TakerGets) and `buys` (TakerPays) as `{asset, value}` (XRP in XRP, not drops; a 40-hex currency code also carries `currency_ascii`), `price` (`buys.value / sells.value`, `null` when `sells` is zero), `funded_ratio`, `expires_at` (ISO 8601 UTC, `null` without an `Expiration`), `expired` (`true` when the `Expiration` is at or before the validated ledger close time) and the offer flags `passive` and `sell`. `funded_ratio` is min(1, available / `sells`), computed for each offer on its own, so offers that share a balance are not netted: available is the spendable XRP (the balance minus the reserve, never below 0) for an offer selling XRP, and for a token the trust line balance (a negative one counts as 0) divided by the issuer's TransferRate / 1e9. It is `1` when the account issues the token it sells, and `0` when the issuer froze the line or all its tokens, when the lines page is complete and holds no line for the token, or when the line of the token the offer buys is deep-frozen by its issuer. It is `null` for an MPT, when the line of the token it sells or buys may lie beyond the 400-line page the route reads, for the offers selling tokens of issuers beyond the first 10 distinct issuers of the page, and when a read it needs failed. Each failed read is named in `checks_failed` (`account`, `lines`, `issuer:<address>`, `ledger`, `reserves`); a failed `ledger` read leaves `expired` `null` for the offers with an `Expiration`. `totals` counts the `offers` of this page and the `unfunded` ones (`funded_ratio` `0`). Besides the page, the route reads only what its offers need: the account entry and the reserves when an offer sells XRP, one page of up to 400 trust lines when an offer sells or buys a token the account does not issue, the account entry of the issuer of each such token an offer sells, and the latest validated ledger when an offer has an `Expiration`. `limit` is 10 to 50 offers (default 20), and `marker` is an opaque cursor: send it back unchanged to get the next page; it is `null` on the last page and only valid for the address that produced it. A page can hold fewer than `limit` offers while `marker` is not `null`, so keep paging until it is `null`. An unknown account answers 404 `not-found`. An answer is fresh for 10 seconds, or 4 seconds when an offer has an `Expiration`, the policy of its latest-ledger read.

## When to use

To see which DEX offers an account has open and whether each can still execute: before cancelling or replacing offers, or to check how much of an account's open offers its balances back.

## When not to use

To read the order book of a pair (use `/v1/xrpl/orderbook`) or estimate the cost of a trade (use `/v1/xrpl/slippage`); for the account's balances and trust lines, use `/v1/xrpl/account/{address}/summary` or `/v1/xrpl/account/{address}/lines`.

## Parameters

| Name | In | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| `address` | path | yes | Account whose open offers are read. | Valid classic XRPL address: starts with `r`, 25 to 35 base58 characters, checksum verified | `rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6` |
| `limit` | query | no | Offers per page. | Integer from 10 to 50; default 20 | `20` |
| `marker` | query | no | Opaque cursor from the previous page's `marker`. | Exactly as returned for this address; any other value is rejected with 400 | `eyJ2IjoxLCJlIjoib2ZmZXJzIiwiYSI6InJHQXMzbnBZeTFWd0xQRTkya3ZLdkEyUVlMUjZGU0E5bjYiLCJtIjoiMDM3ODFBREUzQkYyMTJDREVBNzJGMTBCOTI5QzRDN0FEMTBCNjU5NzA5MDUwNDk3M0NFRDlFRDNDRURCNzg3Riw3MCJ9` |

## Request example

```sh
curl -s "https://api.criptonlabs.com/v1/xrpl/account/rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6/offers?limit=20"
```

## Response example (200)

```json
{
  "address": "rGAs3npYy1VwLPE92kvKvA2QYLR6FSA9n6",
  "limit": 20,
  "offers": [
    {
      "seq": 92973985,
      "sells": {
        "asset": "XRP",
        "value": "10"
      },
      "buys": {
        "asset": "59454C4C4F570000000000000000000000000000.r4ZosXJjnRikUaRyTTAjTx84Si6NJhaazf",
        "value": "106.375797",
        "currency_ascii": "YELLOW"
      },
      "price": "10.6375797",
      "funded_ratio": "1",
      "expires_at": null,
      "expired": false,
      "passive": false,
      "sell": false
    }
  ],
  "totals": {
    "offers": 1,
    "unfunded": 0
  },
  "marker": "eyJ2IjoxLCJlIjoib2ZmZXJzIiwiYSI6InJHQXMzbnBZeTFWd0xQRTkya3ZLdkEyUVlMUjZGU0E5bjYiLCJtIjoiMDM3ODFBREUzQkYyMTJDREVBNzJGMTBCOTI5QzRDN0FEMTBCNjU5NzA5MDUwNDk3M0NFRDlFRDNDRURCNzg3Riw3MCJ9",
  "checks_failed": [],
  "meta": {
    "ledger_index": 108328290,
    "as_of": "2026-11-14T16:35:39.276Z",
    "age_seconds": 0,
    "cache": "miss",
    "stale": false
  }
}
```

## Errors

- 400 [invalid-parameters](https://api.criptonlabs.com/errors/invalid-parameters.md)
- 400 [bad-request](https://api.criptonlabs.com/errors/bad-request.md)
- 404 [not-found](https://api.criptonlabs.com/errors/not-found.md)
- 429 [rate-limited](https://api.criptonlabs.com/errors/rate-limited.md)
- 503 [upstream-unavailable](https://api.criptonlabs.com/errors/upstream-unavailable.md)

## Caching

Fresh for 10 seconds; on upstream failure the last good value is served for up to 120 seconds (`meta.stale` is `true`), then the service answers 503. See the [freshness guide](https://api.criptonlabs.com/docs/guides/freshness.md).

## Rate limit

Tier `expensive`. See the [rate-limits guide](https://api.criptonlabs.com/docs/guides/rate-limits.md).

## MCP tool

The MCP tool `xrpl_account_offers` returns the same data. See the [MCP quickstart](https://api.criptonlabs.com/docs/guides/mcp-quickstart.md).
