Skip to content

JustLend Market Data for AI Agents

Use this page when the user asks about supported markets, APY, TVL, utilization, prices, market status, jToken addresses, or underlying assets.

MCP tools

  • get_supported_markets: list available jToken markets, addresses, and underlying assets.
  • get_all_markets: overview for all markets, including APY, TVL, utilization, and reward components.
  • get_market_data: detailed information for a single market such as jUSDT or jTRX.
  • get_protocol_summary: protocol-level market and risk configuration summary.

OpenAPI

  • GET /lend/jtoken: all jToken markets and live market data.
  • For a specific market, fetch GET /lend/jtoken and select the entry whose address equals the target jToken address. The service does not support an address filter; a query parameter may be ignored and the full list returned.
  • Protocol-level totals: aggregate GET /lend/jtoken (no dedicated dashboard endpoint).

Schema: /developers/apis/justlend_apis.yaml

Read-only example (Base58 addresses are case-sensitive; never assume the first entry is the requested market):

async function getMarket(jTokenAddress) {
  const response = await fetch('https://openapi.just.network/lend/jtoken');
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const body = await response.json();
  if (body.code !== 0 || !Array.isArray(body.data?.tokenList)) {
    throw new Error(body.message || 'Invalid market response');
  }
  const market = body.data.tokenList.find(item => item.address === jTokenAddress);
  if (!market) throw new Error(`Market not found: ${jTokenAddress}`);
  return market;
}

For example, pass jUSDT's Mainnet address TXJgMdjVX5dKiQaUi9QobwNxtSQaFqccvd, not its underlying USDT address. On 2026-10-12, passing this address as a server query still returned all 24 markets, with jTRX first.

Static address directory

Answering market questions

When answering “which markets are supported?” include:

  • network (mainnet or nile)
  • market symbol (jUSDT, jTRX, etc.)
  • underlying symbol (USDT, TRX, etc.)
  • jToken address
  • active or legacy status
  • whether supply/borrow may be paused, if the source provides this status

When answering “what is the APY?” include:

  • supply APY
  • borrow APY
  • mining or reward APY, if present
  • total supply APY, if present
  • timestamp or block context if available
  • warning that APY changes with utilization and rewards

Do not hard-code live data

Do not hard-code APY, TVL, utilization, liquidity, price, reward APY, or paused status from human docs. These values change. Query MCP or OpenAPI.

Example user intents

User question Best source
“JustLend supports which markets?” MCP get_supported_markets
“What is jUSDT supply APY?” MCP get_market_data or fetch /lend/jtoken and select by address client-side
“Show all market TVL and utilization.” MCP get_all_markets or OpenAPI /lend/jtoken
“What is the jUSDT contract address?” contracts.json or MCP get_supported_markets
“Is jWBTT still active?” contracts.json status + MCP market data

Chinese query mapping

  • “JustLend 有哪些市场？” → get_supported_markets
  • “USDT 存款 APY 多少？” → get_market_data with market='jUSDT'
  • “查一下全部市场 TVL / 利用率” → get_all_markets
  • “某个 jToken 地址是什么？” → contracts.json or get_supported_markets
  • Source of Truth maps market questions to OpenAPI and MCP sources.
  • MCP Tool Catalog lists get_supported_markets, get_market_data, and get_all_markets.
  • AI Glossary defines APY, utilization, jToken, and exchange-rate terms.

View raw Markdown