poolDetails

Fetch pool and market data across protocols.

poolDetails(inputs: [PoolInput!]!): MultiPoolResponse!

Returns pool-level data (APY, TVL, token metadata) for one or more pools across protocols.

Warning

Maximum 5 inputs per request. Requests with more than 5 inputs are rejected.

Warning

Rate limit: 100 requests per 60-second window. Maximum 5 inputs per request. Exceeding the limit returns HTTP 429.

Input

input PoolInput {
  protocol: String!    # "morpho" | "pendle" | "aave"
  chainId: Int!        # Chain ID
  poolAddress: String! # Pool/vault/market contract address
}

Field	Type	Description
protocol	String!	Protocol identifier
chainId	Int!	Blockchain network ID
poolAddress	String!	Pool or market contract address (hex)

Info

Pool details are currently supported for Morpho, Pendle, and Aave.

Response

type PoolOutput {
  protocol: String!    # Protocol that returned the data
  chainId: Int!        # Chain ID of the pool
  poolAddress: String! # Pool address queried
  data: String!        # JSON-serialized protocol-native pool data
}

type MultiPoolResponse {
  data: [PoolOutput!]!
  errors: [PoolProtocolError!]!
}

Warning

The data field is a JSON string. Parse it with JSON.parse() to access the typed object. Use the type field in the parsed object to determine the response shape.

Note

Partial failures: If one protocol fails, the others still return data. Always check both data and errors arrays in the response.

Examples

Morpho supports two pool types. Pass a vault address (42-character hex) for vault pool data, or a market unique key (66-character hex) for market pool data.

Vault pool

Query

query {
  poolDetails(inputs: [
    { protocol: "morpho", chainId: 1, poolAddress: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb" }
  ]) {
    data { protocol chainId poolAddress data }
    errors { protocol chainId poolAddress error { code message retryable } }
  }
}

Parsed data field

{
  "type": "morpho-vault-pool",
  "vaultAddress": "0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb",
  "name": "Morpho Blue USDC",
  "symbol": "mbUSDC",
  "asset": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "symbol": "USDC", "decimals": 6 },
  "chainId": 1,
  "network": "mainnet",
  "apy": 0.072,
  "netApy": 0.068,
  "avgApy": 0.065,
  "avgNetApy": 0.061,
  "totalAssets": "52000000000",
  "totalAssetsUsd": 52000000.0,
  "totalSupply": "50800000000000000000000"
}

Market pool

Query

query {
  poolDetails(inputs: [
    { protocol: "morpho", chainId: 1, poolAddress: "0xb323495f7e4148be5643a4ea4a8221eef163e4bccfdedc2a6f4696baacbc86cc" }
  ]) {
    data { protocol chainId poolAddress data }
    errors { protocol chainId poolAddress error { code message retryable } }
  }
}

Parsed data field

{
  "type": "morpho-market-pool",
  "marketId": "0xb323495f7e4148be5643a4ea4a8221eef163e4bccfdedc2a6f4696baacbc86cc",
  "loanAsset": { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "symbol": "USDC", "decimals": 6 },
  "collateralAsset": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "symbol": "WETH", "decimals": 18 },
  "chainId": 1,
  "metrics": {
    "supplyApy": 0.042, "borrowApy": 0.058,
    "netSupplyApy": 0.055, "netBorrowApy": 0.045,
    "fee": 0.1, "utilization": 0.72
  },
  "tvl": {
    "supplyAssets": "120000000000", "supplyAssetsUsd": 120000000.0,
    "borrowAssets": "86400000000", "borrowAssetsUsd": 86400000.0,
    "collateralAssets": "28000000000000000000000", "collateralAssetsUsd": 88200000.0,
    "liquidityAssets": "33600000000", "liquidityAssetsUsd": 33600000.0
  },
  "lltv": 0.86
}