{"uid":"cap_P3yWUTtnlL9WgM7elsDd6","slug":"arkham-x402-entity-loan-defi-balances-04be09c6","name":"Arkham x402 — Entity Loan/DeFi Balances","description":"Get Arkham loan and borrow positions for an entity. $0.60 per call.","url":"https://api.arkm.com/x402/loans/entity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chains":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Chains to filter by, as a single comma-separated value (e.g. 'ethereum,arbitrum_one'). If omitted, returns loan positio…"},"entity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The entity ID to query loan positions for. Accepts both Arkham entity IDs and user entity IDs."}}},"responseSchema":{"type":"json","example":{"balances":{"ethereum":[{"id":"usd-coin","usd":10875.867582,"name":"Aave Ethereum USDC","type":"supplied","price":1,"market":"0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c","symbol":"aEthUSDC","address":"0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c","balance":10875.867582,"protocol":"AAVE_V3","quoteTime":"2026-07-07T14:55:39.964Z","price24hAgo":1,"underlyingAssetID":"usd-coin","underlyingAssetAddress":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"id":"tether","usd":5673.819058,"name":"Aave Ethereum USDT","type":"supplied","price":1,"market":"0x23878914EFE38d27C4D67Ab83ed1b93A74D4086a","symbol":"aEthUSDT","address":"0x23878914EFE38d27C4D67Ab83ed1b93A74D4086a","balance":5673.819058,"protocol":"AAVE_V3","quoteTime":"2026-07-07T14:55:32.963Z","price24hAgo":1,"underlyingAssetID":"tether","underlyingAssetAddress":"0xdAC17F958D2ee523a2206206994597C13D831ec7"}],"arbitrum_one":[{"id":"usdt0","usd":1676.612954,"name":"Aave Arbitrum USDT","type":"supplied","price":1,"market":"0x6ab707Aca953eDAeFBc4fD23bA73294241490620","symbol":"aArbUSDT","address":"0x6ab707Aca953eDAeFBc4fD23bA73294241490620","balance":1676.612954,"protocol":"AAVE_V3","quoteTime":"2026-07-07T14:55:44.119Z","price24hAgo":1,"underlyingAssetID":"usdt0","underlyingAssetAddress":"0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9"},{"id":"usd-coin","usd":29.871206,"name":"Aave Arbitrum USDCn","type":"supplied","price":1,"market":"0x724dc807b04555b71ed48a6896b6F41593b8C637","symbol":"aArbUSDCn","address":"0x724dc807b04555b71ed48a6896b6F41593b8C637","balance":29.871206,"protocol":"AAVE_V3","quoteTime":"2026-07-07T14:55:39.964Z","price24hAgo":1,"underlyingAssetID":"usd-coin","underlyingAssetAddress":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"}]},"entities":{"binance":{"id":"binance","name":"Binance","note":"","type":"cex","service":null,"twitter":"https://twitter.com/binance","website":"https://binance.com","linkedin":"https://www.linkedin.com/company/binance","crunchbase":"https://www.crunchbase.com/organization/binance","description":"","populatedTags":[{"id":"proof-of-reserves","rank":20,"label":"Binance Proof of Reserves","tagParams":"Binance","disablePage":false,"excludeEntities":false},{"id":"cex","rank":50,"label":"Centralized Exchange","disablePage":false,"excludeEntities":false}]}},"totalPositions":{"ethereum":18641.93066428793,"arbitrum_one":1725.575789815171}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HiyJgju2RFh650lJDvhrG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns DeFi lending and borrowing positions (loans, supplied assets) for a named on-chain entity across multiple chains, via Arkham's wallet intelligence platform.","exampleAgentPrompt":"Using Arkham's wallet intelligence, look up the current DeFi loan and supplied asset positions for the entity 'binance' — I want to see their AAVE balances broken down by chain with USD values.","exampleUseCases":[{"title":"Monitor exchange DeFi lending exposure","prompt":"Can you pull up all of Binance's current DeFi lending positions from Arkham? I want to see what they've supplied to AAVE across Ethereum and Arbitrum, with current USD values."},{"title":"Crypto fund due diligence on DeFi risk","prompt":"I'm doing due diligence on a crypto fund — can you use Arkham to get their on-chain DeFi loan and supplied asset positions so I can assess their leverage and protocol exposure?"},{"title":"Track stablecoin supply across DeFi protocols","prompt":"Look up the DeFi lending balances for the entity 'jump-trading' on Arkham — specifically how much stablecoin they have supplied across different lending protocols and chains right now."}],"resultDescription":"Returns a JSON object with per-chain DeFi balances (supplied assets, loan positions), including token ID, symbol, USD value, protocol name (e.g. AAVE_V3), market contract address, balance amount, price, 24h ago price, quote timestamp, and entity metadata such as name, type, website, and social links.","failureModes":["Unknown or unrecognized entity name returns empty balances or 404","Entity exists but has no active DeFi positions — empty balances array returned","Insufficient USDC balance for x402 payment causes payment failure before request is served","Malformed entity ID in request body results in 400 bad request","Chain-specific data may be delayed or unavailable during indexing lag","Rate limiting if too many concurrent requests are made"],"whenToPreferThis":"Choose this endpoint when you need structured, entity-labeled DeFi lending and borrowing positions for a known on-chain actor (exchange, fund, whale, protocol) across multiple chains — particularly when Arkham's entity attribution (mapping addresses to named entities like 'Binance') is the key value-add over raw on-chain queries. Prefer this over generic blockchain explorers when you need aggregated multi-chain DeFi exposure in USD, already attributed to a named institutional or notable entity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:49.571Z","isFirstParty":false}