Console

POSTamm_info

XRP Ledger Mainnethttps://xrpl-mainnet.nodit.io/

Returns information about an Automated Market Maker (AMM) instance. It lets you check the deposited asset amounts, the LP token supply, the trading fee and the auction slot state.

Request Body
methodstringrequired
amm_accountstring

The special account address of the AMM. It is also the issuer of the LP tokens.

assetobject

Specifies an asset by currency code and issuer. Omit issuer for XRP.

currencystring

The currency code. Pass XRP for XRP.

issuerstring

The address of the account that issued the token. Omit for XRP.

asset2object

Specifies an asset by currency code and issuer. Omit issuer for XRP.

currencystring

The currency code. Pass XRP for XRP.

issuerstring

The address of the account that issued the token. Omit for XRP.

accountstring

Also returns the amount of LP tokens held by this account.

ledger_hashstring

The hash of the ledger version to use. Pass a 32-byte hex string.

ledger_indexinteger

Specifies the ledger version to use. Pass a ledger index as an integer, or use one of the shortcut strings below.

  • validated: Uses the most recent ledger version validated by the network.
  • closed: Uses the most recent ledger version the server has closed. It may not be validated.
  • current: Uses the in-progress ledger version the server is currently building.

The ledger index of the version to use.

Responses
accountstring

The special account address of the AMM. It is also the issuer of the LP tokens.

amountoneOf

Represents an amount. XRP is expressed as a string in drops; tokens are expressed as an object.

XRP Amountstring
Token Amountobject
currencystring

The currency code. Either a 3-character code or a 40-character hex string.

issuerstring

The address of the account that issued the token.

valuestring

The amount expressed as a string.

amount2oneOf

Represents an amount. XRP is expressed as a string in drops; tokens are expressed as an object.

XRP Amountstring
Token Amountobject
currencystring

The currency code. Either a 3-character code or a 40-character hex string.

issuerstring

The address of the account that issued the token.

valuestring

The amount expressed as a string.

asset_frozenboolean

Whether the first asset is frozen.

asset2_frozenboolean

Whether the second asset is frozen.

auction_slotobject

Information about the trading fee discount auction slot.

accountstring

The address of the account that currently holds the slot.

discounted_feeinteger

The discounted fee applied to the slot holder, in units of 1/100,000.

priceoneOf

Represents an amount. XRP is expressed as a string in drops; tokens are expressed as an object.

XRP Amountstring
Token Amountobject
currencystring

The currency code. Either a 3-character code or a 40-character hex string.

issuerstring

The address of the account that issued the token.

valuestring

The amount expressed as a string.

time_intervalinteger

The current time interval of the auction slot.

expirationstring

The time the slot expires, in ISO 8601 format.

auth_accountsobject[]

The list of accounts designated to also receive the discounted fee.

accountstring

The account address.

lp_tokenoneOf

Represents an amount. XRP is expressed as a string in drops; tokens are expressed as an object.

XRP Amountstring
Token Amountobject
currencystring

The currency code. Either a 3-character code or a 40-character hex string.

issuerstring

The address of the account that issued the token.

valuestring

The amount expressed as a string.

trading_feeinteger

The trading fee of the AMM, in units of 1/100,000.

vote_slotsobject[]

The current state of trading fee voting.

accountstring

The address of the account that voted.

trading_feeinteger

The trading fee that account voted for, in units of 1/100,000.

vote_weightinteger

The weight of the vote.

ledger_hashstring

The hash of the ledger version used. Returned when a validated ledger version was queried.

ledger_indexinteger

The ledger index of the version used. Returned when a validated ledger version was queried.

ledger_current_indexinteger

The ledger index of the in-progress ledger. Returned when the current ledger was queried.

validatedboolean

Whether the response was derived from a validated ledger version.

X-API-KEY
RequestCU25
cURL
curl -X POST "https://xrpl-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "amm_info",
  "params": [
    {
      "asset": {
        "currency": "XRP"
      },
      "asset2": {
        "currency": "USD",
        "issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q"
      }
    }
  ]
}'
Response
Example · 200
{
  "result": {
    "amm": {
      "account": "rE54zDvgnghAoPopCgvtiqWNq3dU5y836S",
      "amount": "296890496",
      "amount2": {
        "currency": "USD",
        "issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
        "value": "25.5"
      },
      "asset2_frozen": false,
      "asset_frozen": false,
      "auction_slot": {
        "account": "rPzwM2JfCSDjhbesdThqWzMBGKAzHnAdCH",
        "discounted_fee": 60,
        "expiration": "2026-09-03T04:00:00Z",
        "price": {
          "currency": "039C79FE0EFEC1B9F0EDB4F4E6F0E4C8C7B4E2A1",
          "issuer": "rE54zDvgnghAoPopCgvtiqWNq3dU5y836S",
          "value": "0.8696"
        },
        "time_interval": 0
      },
      "lp_token": {
        "currency": "039C79FE0EFEC1B9F0EDB4F4E6F0E4C8C7B4E2A1",
        "issuer": "rE54zDvgnghAoPopCgvtiqWNq3dU5y836S",
        "value": "87500"
      },
      "trading_fee": 600,
      "vote_slots": [
        {
          "account": "rPzwM2JfCSDjhbesdThqWzMBGKAzHnAdCH",
          "trading_fee": 600,
          "vote_weight": 100000
        }
      ]
    },
    "ledger_current_index": 98765433,
    "validated": false
  }
}

Last updated