Get DeFi Balances + Performance

This endpoint returns the DeFi Protocol name, Liquidity Pool/DeFi Strategy Name, Token Balance staked/lent/used in DeFi activities, and DeFi Position (like LP tokens received). It also returns the Principal balance (conceptually similar to cost basis) for the position and the LP Token or Interest Accrual earned over the lifetime of the position. Use this endpoint to track DeFi activities and performance.

DeFi Strategy object taxonomy is as follows:
- Strategy Name
- Strategy Activity (Farm, Lend, Stake, LP, Borrow)
Currency - Accounting data can be calculated and shown in the currency of your choice using the currency parameter. Choose from US Dollar, ETH, MATIC, AVAX or xDAI.
Multiple Addresses: You may submit one or more wallet addresses in this query. For multiple wallet addresses, the response will return the DeFi datapoints outlined above by protocol and then by DeFi Strategy.
Is_Debt - Refers to whether the token position is borrowed or not.
Principal - Refers to the principal investment for the DeFi position (expressed in # of tokens)
Accrual - This refers to the Rewards/LP token income accrual or borrowing interest expense accrual in the native protocol token. For example, earning LOOKS rewards on the LooksRare protocol. Expressed in # of tokens.
Claimable Rewards - This refers to the Rewards income accrual or borrowing interest expense accrual in a token that is not the native protocol token (for example, earning rewards in the form of the underlying token asset in a LP pool). Expressed in # of tokens.
Supported Protocols:
1. Aave v2
2. Abracadabra
3. Apecoin
4. Aura Finance
5. Balancer v1
6. Balancer v2
7. Bancor v3
8. Compound
9. Compound v3
10. Convex
11. Curve
12. Eigenlayer
13. Hop V1
14. Lido
15. LooksRare
16. MakerDAO
17. Maple
18. Moonwell
19. Morpho Blue
20. Sushiswap Bentobox
21. Sushiswap Kashi
22. Stargate
23. Synapse
24. Synthetix
25. Uniswap
26. Uniswap v2
27. Uniswap v3
28. Verse
29. Yearn
  Need a different protocol? Let us know at feedback.openpool.co
Unsupported Protocols: If your wallet includes protocol activity with protocols not supported by OpenPool, then these protocol balances and activities will not show up in the call response.

Successful Query Example

Single Wallet

curl --request GET \
     --url 'https://api.openpool.co/wallet/protocol_balance/?wallet=0xC28eAE2FBc8E4ea7393Afb54528649eCeE259F72' \
     --header 'X-API-KEY: <insert_api_key>' \
     --header 'accept: application/json'

Multiple Wallets

curl --request GET \
     --url 'https://api.openpool.co/wallet/protocol_balance/?wallet=0x59a5493513ba2378ed57ae5ecfb8a027e9d80365%2C0xC28eAE2FBc8E4ea7393Afb54528649eCeE259F72' \
     --header 'X-API-KEY: <insert_api_key>' \
     --header 'accept: application/json'

Successful Response Example

{'wallet': '0x9c21a04468e028f9b7215392bbe5171f634bc76a',
 'name': 'aArbwstETH',
 'category': 'lend',
 'address': '0x513c7E3a9c69cA3e22550eF58AC1C0088e918FFf',
 'protocol': {'id': 'protocol_VtgFGsRPU6FUAFMox3haDu',
  'name': 'Aave V3',
  'slug': 'aave-v3',
  'image_url': 'https://cdn.openpool.co/static/protocols/aave-v2.png'},
 'token': {'id': 'token_E9kiS7UnVaMwXV2zPNUAh4',
  'asset': {'id': 'asset_e4rbgKeqKaLktFiSUmEjHK',
   'name': 'Aave Arbitrum wstETH',
   'symbol': 'aArbwstETH',
   'slug': 'aave-arbitrum-wsteth',
   'is_debt': False},
  'token_id': '0x513c7e3a9c69ca3e22550ef58ac1c0088e918fff_42161',
  'address': '0x513c7e3a9c69ca3e22550ef58ac1c0088e918fff',
  'blockchain': 'blockchain_3pCy2g5sCSNk6MWGgvY2NP'},
 'balance': 0.545,
 'price': 1801.75,
 'value': 981.9537500000001,
 'principal': 0.54497906,
 'accrual': 2.094000000008034e-05,
 'claimable_rewards': None,
 'underlyings': {'token': {'id': 'token_2NfYnXT35waTKWMzsjotem',
   'asset': {'id': 'asset_XzioJ9KQH957EaAMghatfo',
    'name': 'Lido wstETH',
    'symbol': 'WSTETH',
    'slug': 'lido-finance-wsteth',
    'is_debt': False},
   'token_id': '0x5979d7b546e38e414f7e9822514be443a4800529_42161',
   'address': '0x5979d7b546e38e414f7e9822514be443a4800529',
   'blockchain': 'blockchain_3pCy2g5sCSNk6MWGgvY2NP'},
  'balance': 0.545,
  'price': 1877.8592305681782,
  'value': 1023.4332806596572},
 'currency': 'USD'}
  
{'wallet': '0x9c21a04468e028f9b7215392bbe5171f634bc76a',
 'name': 'LOOKS',
 'category': 'stake',
 'address': '0xf4d2888d29D722226FafA5d9B24F9164c092421E',
 'protocol': {'id': 'protocol_kRb2B8JnrahZMpiZvWJ6sS',
  'name': 'Looks Rare',
  'slug': 'looksrare',
  'image_url': 'https://cdn.openpool.co/static/protocols/looks-rare.png'},
 'token': {'id': 'token_6MhqnsnyY42fv9iep6AogR',
  'asset': {'id': 'asset_8vxRKbGMaJtG4gnuArVVqh',
   'name': 'LooksRare',
   'symbol': 'LOOKS',
   'slug': 'looksrare',
   'is_debt': False},
  'token_id': '0xf4d2888d29d722226fafa5d9b24f9164c092421e_1',
  'address': '0xf4d2888d29d722226fafa5d9b24f9164c092421e',
  'blockchain': 'blockchain_CXTQHpufgGtMwu8Lktv7Aw'},
 'balance': 1038.3295,
 'price': 0.06106007776223816,
 'value': 63.40048001282587,
 'principal': 500.0,
 'accrual': 538.3295,
 'claimable_rewards': {'token': {'id': 'token_UW735JfmdDJnWpXHG5Bnnj',
   'asset': {'id': 'asset_noo27eksxZ6UTB2Pn3QPQJ',
    'name': 'Wrapped Ethereum',
    'symbol': 'WETH',
    'slug': 'weth',
    'is_debt': False},
   'token_id': '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2_1',
   'address': '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
   'blockchain': 'blockchain_CXTQHpufgGtMwu8Lktv7Aw'},
  'balance': 0.2873,
  'price': 1649.3258542370816,
  'value': 473.8513179223135},
 'underlyings': None,
 'currency': 'USD'}