api.teardrop.dev
Teardrop get_wallet_positions: Get a wallet's DeFi positions across all DeBank-supported chains and protocols. Returns protocol-level positions, asset/debt/net USD values, optional token lists, aggregate exposure, and optional all-chain net worth. Set include_token_balances=true to also return DeBank's complete cross-chain wallet token list. Set include_token_lists=false for a compact balance and debt summary without nested position tokens. This covers substantially more protocols and chains...
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF2Eec9De86274913F85A8aA6427Ad65a9B0bC90a",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://api.teardrop.dev/tools/mcp",
"tags": [
"crypto",
"defi",
"onchain data",
"wallet analytics",
"ai agents"
],
"iconUrl": "https://teardrop.dev/teardrop.png",
"mimeType": "application/json",
"description": "Teardrop MCP gateway: pay-per-call tools for AI agents covering token prices, DeFi yields and lending, wallet portfolios and approvals, onchain transactions, DEX quotes, and web search. Call via MCP tools/call over streamable HTTP; settle with x402 USDC on Base.",
"serviceName": "Teardrop"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"id": 1,
"method": "tools/call",
"params": {
"name": "get_token_price",
"arguments": {
"tokens": [
"ETH"
]
}
},
"jsonrpc": "2.0"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"id": 1,
"result": {
"content": [
{
"text": "{\"vs_currency\":\"usd\",\"prices\":[{\"id\":\"ethereum\",\"symbol\":\"eth\",\"price\":3500.0,\"market_cap\":null,\"volume_24h\":null,\"change_24h_pct\":null}]}",
"type": "text"
}
],
"isError": false
},
"jsonrpc": "2.0"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"jsonrpc",
"id",
"method",
"params"
],
"properties": {
"id": {
"oneOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
},
"method": {
"type": "string",
"const": "tools/call"
},
"params": {
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"arguments": {
"type": "object"
}
},
"additionalProperties": false
},
"jsonrpc": {
"type": "string",
"const": "2.0"
}
},
"additionalProperties": false
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
Pay 0.02 USDC on Base to 0xF2Ee…bC90a. The signed payment is good for 5 minutes.
- Paid to
- 0xF2Ee…bC90a
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 20000 smallest units
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF2Eec9De86274913F85A8aA6427Ad65a9B0bC90a",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "mcp",
"toolName": "get_wallet_positions",
"transport": "streamable-http",
"description": "Get a wallet's DeFi positions across all DeBank-supported chains and protocols. Returns protocol-level positions, asset/debt/net USD values, optional token lists, aggregate exposure, and optional all-chain net worth. Set include_token_balances=true to also return DeBank's complete cross-chain wallet token list. Set include_token_lists=false for a compact balance and debt summary without nested position tokens. This covers substantially more protocols and chains than the block-accurate get_defi_…",
"inputSchema": {
"type": "object",
"title": "GetWalletPositionsInput",
"required": [
"wallet_address"
],
"properties": {
"wallet_address": {
"type": "string",
"title": "Wallet Address",
"description": "EVM wallet address (0x…)"
},
"include_net_worth": {
"type": "boolean",
"title": "Include Net Worth",
"default": true,
"description": "Include all-chain net worth and per-chain balances; disable to avoid that additional provider request."
},
"include_token_lists": {
"type": "boolean",
"title": "Include Token Lists",
"default": true,
"description": "Include protocol position token lists; disable for a compact balance and debt summary."
},
"include_token_balances": {
"type": "boolean",
"title": "Include Token Balances",
"default": false,
"description": "Include DeBank's complete cross-chain token balance list; adds a billable provider request."
}
}
}
},
"output": {
"type": "json",
"example": {
"provenance": {},
"data_complete": false,
"wallet_address": "",
"include_net_worth": false,
"include_token_lists": false,
"include_token_balances": false
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"toolName",
"inputSchema"
],
"properties": {
"type": {
"type": "string",
"const": "mcp"
},
"toolName": {
"type": "string"
},
"transport": {
"enum": [
"streamable-http",
"sse"
],
"type": "string"
},
"description": {
"type": "string"
},
"inputSchema": {
"type": "object"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"wallet_address",
"include_net_worth",
"include_token_balances",
"include_token_lists",
"data_complete",
"provenance"
],
"properties": {
"note": {
"type": "string"
},
"errors": {
"type": "array"
},
"positions": {
"type": "array"
},
"provenance": {
"type": "object",
"description": "Machine-readable source and freshness metadata for a tool response."
},
"data_complete": {
"type": "boolean"
},
"total_net_usd": {
"type": [
"number",
"null"
]
},
"chain_balances": {
"type": "array"
},
"token_balances": {
"type": "array"
},
"total_debt_usd": {
"type": [
"number",
"null"
]
},
"wallet_address": {
"type": "string"
},
"total_asset_usd": {
"type": [
"number",
"null"
]
},
"include_net_worth": {
"type": "boolean"
},
"staleness_seconds": {
"type": [
"number",
"null"
],
"description": "Max age in seconds of the underlying DeBank position data (from per-item update_at), or None when unavailable."
},
"include_token_lists": {
"type": "boolean"
},
"total_net_worth_usd": {
"type": [
"number",
"null"
]
},
"include_token_balances": {
"type": "boolean"
}
}
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-10-08 00:43Z
- Last indexed by Roundhouse
- 2026-10-27 02:00Z
- Last enriched (probe, favicon, geo)
- 2026-10-05 09:15Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 22 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service api.teardrop.dev and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=api.teardrop.dev' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://api.teardrop.dev/tools/mcp#get_wallet_positions, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Either pay over x402 (mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402), or ask me for an organization key, which I create at https://roundhouseai.io/dashboard/connections. If you have neither, ask before going further. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.