DeFi Protocol Positions

GET /gateway/v1/wallet/protocols

Wallet DeFi Protocol Positions

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/wallet/protocols

200

{
  "data": [
    {
      "chain": "<string>",
      "positions": [
        {
          "balance_usd": 123,
          "name": "<string>",
          "borrow_tokens": [
            {
              "amount": 123,
              "chain": "<string>",
              "price": 123,
              "symbol": "<string>",
              "name": "<string>",
              "token_address": "<string>"
            }
          ],
          "lp_tokens": [
            {
              "amount": 123,
              "chain": "<string>",
              "price": 123,
              "symbol": "<string>",
              "name": "<string>",
              "token_address": "<string>"
            }
          ],
          "reward_tokens": [
            {
              "amount": 123,
              "chain": "<string>",
              "price": 123,
              "symbol": "<string>",
              "name": "<string>",
              "token_address": "<string>"
            }
          ],
          "supply_tokens": [
            {
              "amount": 123,
              "chain": "<string>",
              "price": 123,
              "symbol": "<string>",
              "name": "<string>",
              "token_address": "<string>"
            }
          ]
        }
      ],
      "protocol_name": "<string>",
      "total_usd": 123,
      "logo_url": "<string>",
      "site_url": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseWalletProtocolItem.json"
}

Query Parameters

address · string · required

Wallet address — must be a raw 0x-prefixed hex address, not an ENS name

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

offset · integer<int64> · default: 0

Pagination offset

Required range: x >= 0

Example:

0

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseWalletProtocolItem.json"