Honeycluster Docs – Get an AMM pool detail by ammId

amm

Get an AMM pool detail by ammId

get

/amm/{ammId}

operationId: pool-getDetail

Returns the full detail view for a single AMM pool identified by its on-chain ammId (XRPL classic address). Shape mirrors the token-detail response: metadata.pool (amm_id, owner, trading_fee_bps), metadata.asset1 / metadata.asset2 / metadata.lp_token (currency + issuer triples), metrics (reserves, LP supply, TVL, 24h/7d event counts), and flags. Returns null if no pool matches.

Authorizations

Name	Location	Details
`BearerAuth`	Authorization header · bearer	JWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.

Path Parameters

Name	Type	Default	Description
`ammId` required	string		AMM account identifier (XRPL classic address).

Responses

200

application/json

Successful response

Example

Json

{
  "id": "3c4a3de8-4218-400c-8c55-87dc27206753",
  "amm_id": "rEgH8Y8nF9XuvvRECnp6e9VRZqKM3KZUtN",
  "ledger_index": 103801288,
  "flags": {
    "destroyed": false
  },
  "metadata": {
    "pool": {
      "amm_id": "rEgH8Y8nF9XuvvRECnp6e9VRZqKM3KZUtN",
      "owner": "rOwnerExample1234567890",
      "trading_fee_bps": 500
    },
    "asset1": {
      "currency": "XRP",
      "issuer": null
    },
    "asset2": {
      "currency": "USD",
      "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
    },
    "lp_token": {
      "currency": "03CE3395056E7BEDE14E4CA83D6B80FF83D51F97",
      "issuer": "rEgH8Y8nF9XuvvRECnp6e9VRZqKM3KZUtN"
    }
  },
  "metrics": {
    "asset1_reserve": "128450.32",
    "asset2_reserve": "65812.18",
    "lp_token_supply": "91500.55",
    "tvl_xrp": "256900.64",
    "events_24h": 412,
    "events_7d": 2891,
    "swaps_24h": 388,
    "swaps_7d": 2705
  }
}

400

application/json

Invalid input data

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401

application/json

Authorization not provided

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403

application/json

Insufficient access

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404

application/json

Not found

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500

application/json

Internal server error

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}