{"uid":"cap_nmtDYGf1uZzIPl4tmlcDH","slug":"arkham-loans-by-address-42736bf9","name":"Arkham Loans by Address","description":"Get Arkham loan and borrow positions for an address. $0.20 per call.","url":"https://api.arkm.com/x402/loans/address","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…"},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The blockchain address to query loan positions for."}}},"responseSchema":{"type":"json","example":{"balances":{"ethereum":[{"id":"usd-coin","usd":213778.237113,"name":"USD Coin","type":"borrowed","price":1,"market":"0xc3d688B66703497DAA19211EEdff47f25384cdc3","symbol":"USDC","address":"0xc3d688B66703497DAA19211EEdff47f25384cdc3","balance":213778.237113,"protocol":"COMPOUND_V3","quoteTime":"2026-07-07T15:34:50.955Z","price24hAgo":1,"balanceExact":"213778237113","underlyingAssetID":"usd-coin","underlyingAssetAddress":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}],"arbitrum_one":[{"id":"usd-coin","usd":23792.73678,"name":"USD Coin","type":"borrowed","price":1,"market":"0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf","symbol":"USDC","address":"0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf","balance":23792.73678,"protocol":"COMPOUND_V3","quoteTime":"2026-07-07T15:34:50.955Z","price24hAgo":1,"balanceExact":"23792736780","underlyingAssetID":"usd-coin","underlyingAssetAddress":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"}]},"addresses":{"ethereum":{"0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd":{"chain":"ethereum","address":"0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd","contract":false,"arkhamLabel":{"name":"etherean.eth","address":"0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd","chainType":"evm"},"isUserAddress":false}},"arbitrum_one":{"0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd":{"chain":"arbitrum_one","address":"0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd","contract":false,"arkhamLabel":{"name":"etherean.eth","address":"0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd","chainType":"evm"},"isUserAddress":false}}},"totalPositions":{"ethereum":359915.8033752398,"arbitrum_one":48146.42974611472}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MjjKSIruTsh-Tj-L5wfnf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns DeFi loan/borrow positions for a given wallet address across multiple chains, including borrowed balances, protocols, and USD values.","exampleAgentPrompt":"Pull all active DeFi loan and borrow positions for the wallet 0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd across Ethereum and Arbitrum — I want to see the borrowed amounts, protocols like Compound V3, and total USD values per chain.","exampleUseCases":[{"title":"DeFi debt exposure audit","prompt":"Look up all outstanding borrow positions for wallet 0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd and tell me how much they owe across Ethereum and Arbitrum, broken down by protocol and token."},{"title":"Compound V3 loan monitoring","prompt":"Check the Arkham loans data for address 0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd — I need to know their current Compound V3 borrow balances in USD and whether those positions have changed in the last 24 hours."},{"title":"On-chain credit risk assessment","prompt":"I'm evaluating this whale wallet 0xaD1fB851e54C55D65D8CEfE65f9E4c64A83650fd — can you fetch their total DeFi loan exposure on Ethereum and Arbitrum so I can estimate their liquidation risk?"}],"resultDescription":"Returns a JSON object containing borrowed token balances organized by chain (e.g. ethereum, arbitrum_one), each entry including token id, name, symbol, USD value, exact balance, protocol name (e.g. COMPOUND_V3), market contract address, quote timestamp, and 24h-ago price. Also includes address metadata with Arkham labels and per-chain total position values in USD.","failureModes":["Invalid or malformed wallet address returns an error","Address with no loan positions returns empty balance arrays","Unsupported chain in request may return no data for that chain","Rate limiting or payment failure (x402) results in 402 Payment Required","Network timeout if on-chain data is slow to resolve"],"whenToPreferThis":"Use this endpoint when you need detailed, multi-chain DeFi borrow/loan position data for a specific wallet address, especially with Arkham's proprietary address labeling. Prefer this over generic on-chain RPCs when you need pre-aggregated protocol-level loan data with USD valuations and want coverage across Ethereum and Arbitrum in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:51:26.935Z","isFirstParty":false}