amm_info

Gets information about an Automated Market Maker (AMM) instance, identified either by its asset pair or by its AMM account.

This method will use 20 Compute Units.

---

Reference: Here

Parameters

• asset (object, optional) One of the assets of the AMM to look up, as an object with currency and issuer fields (omit issuer for XRP).

• asset2 (object, optional) The other of the assets of the AMM, in the same format.

• amm_account (string, optional) The address of the AMM's special AccountRoot. Use this instead of asset and asset2.

• account (string, optional) Show only LP Tokens held by this liquidity provider.

• ledger_hash (string, optional) The unique hash of the ledger version to use.

• ledger_index (number or string, optional) The ledger index of the ledger to use, or a shortcut string such as validated, closed or current.

Returns

• amm (object) An AMM description object with account, amount, amount2, asset_frozen, asset2_frozen, auction_slot, lp_token, trading_fee (in units of 1/100,000) and vote_slots.

• ledger_current_index (number) Omitted if ledger_index is provided instead.

• ledger_hash (string) The identifying hash of the ledger version used.

• ledger_index (number) The ledger index of the ledger version used.

• validated (boolean) If true, the ledger used for this request is validated and these results are final.

// Result
{
  "result": {
    "amm": {
      "lp_token": {
        "currency": "03B245BE580EC4F4386A751C084489EC4B514A2F",
        "issuer": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
        "value": "1670650031.109153"
      },
      "amount": "1597600393232",
      "amount2": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "value": "2422049.846261711"
      },
      "account": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
      "trading_fee": 197,
      "auction_slot": {
        "time_interval": 20,
        "price": {
          "currency": "03B245BE580EC4F4386A751C084489EC4B514A2F",
          "issuer": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
          "value": "131482.3939333034"
        },
        "discounted_fee": 19,
        "account": "r4uKh2rHuarMZdAgSBYqqicX7MxPBegttw",
        "expiration": "2026-03-02T17:05:00+0000",
        "auth_accounts": [
          {
            "account": "rNy92d5CrBQ1eC5HUokq1LDfcuLPvTfh4X"
          },
          // ...
        ]
      },
      "vote_slots": [
        {
          "account": "rJ4XeEzorvsQp6un4h9CjtANEsB3Qcc8iA",
          "trading_fee": 300,
          "vote_weight": 3129
        },
        // ...
      ],
      "asset2_frozen": false
    },
    "ledger_index": 107292935,
    "ledger_hash": "3FF4EFB0A896061499DCE559C21A44563F74C040226019033B06BA6FC383B450",
    "validated": true,
    "status": "success"
  }
}

mainnet

curl https://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"method":"amm_info","params":[{"asset":{"currency":"XRP"},"asset2":{"currency":"524C555344000000000000000000000000000000","issuer":"rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De"},"ledger_index":"validated"}]}'

Over WebSocket, send {"id":1,"command":"amm_info","asset":{"currency":"XRP"},"asset2":{"currency":"524C555344000000000000000000000000000000","issuer":"rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De"},"ledger_index":"validated"} to wss://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE>.