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"
  }
}

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>.

Node API

Account

Endpoints

Admin API

Resources

Chains

Reference: Here

Parameters

Returns

​Reference: Here

​Parameters

​Returns

Reference: Here

Parameters

Returns