Are you trying to entry decentralized finance (DeFi) protocol information simply? If that’s the case, you’re in the precise place. This information introduces Moralis’ DeFi API – your go-to answer for querying DeFi information. With the DeFi API, you may effortlessly fetch protocol information for any pockets with only a single API name. Desperate to get going? Right here’s the way to rapidly retrieve a abstract of the DeFi protocols a pockets interacts with:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.builders.moralis.com/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/abstract?chain=eth’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Operating the code above gives a abstract of all DeFi protocols linked to a pockets, together with the variety of positions, whole USD worth, unclaimed rewards, protocol names, logos, and extra. Right here’s an instance of the output:
{
active_protocols: 8,
total_positions: 12,
total_usd_value: 871.6550972487607,
total_unclaimed_usd_value: 26.31655680118138,
protocols: [
{
protocol_name: ‘Uniswap v3’,
protocol_id: ‘uniswap-v3’,
protocol_url: ‘https://app.uniswap.org’,
protocol_logo: ‘https://cdn.developers.moralis.com/defi/uniswap.png’,
total_usd_value: 433.6700616074799,
total_unclaimed_usd_value: 26.31655680118138,
positions: 3
},
//…
]
}
That’s it! Fetching DeFi protocol information is simple with Moralis. For an in depth breakdown, take a look at the official DeFi API documentation or comply with this information to be taught extra.
Prepared to start out querying DeFi protocol information? Join a free Moralis account to entry our industry-leading growth instruments immediately!
Overview
Pockets holders usually have vital parts of their portfolios locked in DeFi protocols to, as an example, earn yield. Nevertheless, monitoring these positions might be difficult, complicating the event of instruments like portfolio trackers, wallets, and tax platforms. That’s why we launched our DeFi Positions function.
With Moralis’ DeFi Positions, you may question DeFi protocol information with only a few traces of code. Are you interested in the way it works? If that’s the case, be part of us on this information, and we’ll present you. Let’s dive in!
What’s DeFi Protocol Knowledge?
DeFi protocol information encompasses detailed details about a pockets’s positions throughout numerous DeFi platforms, comparable to Uniswap and Aave. This information contains liquidity positions, yield farming actions and different interactions inside the DeFi ecosystem. On condition that many pockets holders lock property in DeFi protocols, this information is essential for constructing portfolio trackers, crypto tax platforms, and different Web3 tasks, together with making certain general correct monetary reporting.
Historically, retrieving DeFi protocol information has been advanced and time-consuming. Nevertheless, Moralis’ DeFi API simplifies this course of, providing a streamlined technique to entry complete DeFi protocol information.
So, what precisely is Moralis’ DeFi API, and the way does it work? Let’s discover its options and advantages!
Moralis’ DeFi API – The Best Solution to Get DeFi Protocol Knowledge
Moralis’ DeFi API is the best and strongest technique to entry DeFi protocol information. This main API gives a unified interface to question liquidity pairs, ERC-20 allowances, liquidity supplier tokens, DeFi positions, and extra – multi functional place.
With strong cross-chain assist, Moralis’ DeFi API allows you to retrieve information throughout main blockchain networks and protocols, together with Ethereum, Polygon, BNB Sensible Chain (BSC), and others.
As such, whether or not you’re creating lending platforms, portfolio trackers, or related functions, Moralis’ DeFi API equips you with the required instruments.
So, how will you use Moralis’ DeFi API to get protocol information? That is the place our DeFi Positions function comes into play!
Introducing Moralis’ DeFi Positions
One of many DeFi API’s most outstanding options is DeFi Positions, which gives complete perception into any pockets’s DeFi actions. However what does this truly entail? Our DeFi Positions function contains three key endpoints:
Abstract DeFi Protocols by Pockets
Retrieve a complete abstract of all DeFi protocols related to a particular pockets deal with. Under is an instance of the endpoint in motion:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.builders.moralis.com/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/abstract?chain=eth’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Once you name this endpoint, you’ll obtain an in depth abstract of the DeFi protocols the pockets interacts with, together with the full USD worth of all positions, unclaimed rewards, protocol names, and extra related information. Right here’s an instance of the response:
{
active_protocols: 8,
total_positions: 12,
total_usd_value: 871.6550972487607,
total_unclaimed_usd_value: 26.31655680118138,
protocols: [
{
protocol_name: ‘Uniswap v3’,
protocol_id: ‘uniswap-v3’,
protocol_url: ‘https://app.uniswap.org’,
protocol_logo: ‘https://cdn.developers.moralis.com/defi/uniswap.png’,
total_usd_value: 433.6700616074799,
total_unclaimed_usd_value: 26.31655680118138,
positions: 3
},
//…
]
}
Abstract DeFi Positions by Pockets
Fetch a abstract of all DeFi positions related to a pockets, together with unclaimed rewards for every place. Down under, you’ll discover an instance of what it would appear to be when calling this endpoint:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.builders.moralis.com/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/positions?chain=eth’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Operating the code above returns an in depth abstract of all DeFi positions for a pockets. This contains place labels, related tokens, USD values for every place, and different related particulars. Right here’s an instance output:
[
{
“protocol_name”: “Uniswap v2”,
“protocol_id”: “uniswap-v2”,
“protocol_url”: “https://app.uniswap.org/pools/v2”,
“protocol_logo”: “https://cdn.developers.moralis.com/defi/uniswap.png”,
“position”: {
“label”: “liquidity”,
“tokens”: [
{
“token_type”: “supplied”,
“name”: “USD Coin”,
“symbol”: “USDC”,
“contract_address”: “0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48”,
“decimals”: “6”,
“logo”: “https://logo.developers.moralis.com/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_ac01a87aaf98ddb0f349ee4ebe97f0d8”,
“thumbnail”: “https://logo.developers.moralis.com/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_ac01a87aaf98ddb0f349ee4ebe97f0d8”,
“balance”: “9762775.56142477145245169357”,
“balance_formatted”: “9.76277556142477145245169357”,
“usd_price”: 0.9999274263552301,
“usd_value”: 9.76206704121921
},
//…
],
“deal with”: “0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc”,
“balance_usd”: 19.509109037404016,
“total_unclaimed_usd_value”: 5.127740503730312,
“position_details”: {
“reserve0”: “9.76277556142477145245169357”,
“reserve1”: “0.00356975548622332765688138345279600856”,
“manufacturing unit”: “0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f”,
“pair”: “0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc”,
“share_of_pool”: 0.000021077221080781
}
}
},
//…
]
Detailed DeFi Positions by Pockets & Protocol
Question detailed information on positions for a particular pockets and protocol. Right here’s an instance of what it would appear to be:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.builders.moralis.com/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/uniswap-v3/positions?chain=eth’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Operating the code returns complete DeFi positions for the required pockets and protocol, together with place labels, tokens, USD values for every place, unclaimed rewards, and extra. See an instance response under:
{
“protocol_name”: “Uniswap v3”,
“protocol_id”: “uniswap-v3”,
“protocol_url”: “https://app.uniswap.org”,
“protocol_logo”: “https://cdn.builders.moralis.com/defi/uniswap.png”,
“total_usd_value”: 433.28689509249983,
“total_unclaimed_usd_value”: 26.291817301924766,
“positions”: [
{
“label”: “liquidity”,
“tokens”: [
{
“token_type”: “supplied”,
“name”: “Coinbase Wrapped Staked ETH”,
“symbol”: “cbETH”,
“contract_address”: “0xbe9895146f7af43049ca1c1ae358b0541ea49704”,
“decimals”: “18”,
“logo”: “https://logo.developers.moralis.com/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049”,
“thumbnail”: “https://logo.developers.moralis.com/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049”,
“balance”: “0”,
“balance_formatted”: “0”,
“usd_price”: 2937.5037898342443,
“usd_value”: 0
},
//…
{
“token_type”: “reward”,
“name”: “Coinbase Wrapped Staked ETH”,
“symbol”: “cbETH”,
“contract_address”: “0xbe9895146f7af43049ca1c1ae358b0541ea49704”,
“decimals”: “18”,
“logo”: “https://logo.developers.moralis.com/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049”,
“thumbnail”: “https://logo.developers.moralis.com/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049”,
“balance”: “880092663147703”,
“balance_formatted”: “0.000880092663147703”,
“usd_price”: 2937.5037898342443,
“usd_value”: 2.5852755334016906
},
//…
],
“deal with”: “0x840deeef2f115cf50da625f7368c24af6fe74410”,
“balance_usd”: 78.95335940631567,
“total_unclaimed_usd_value”: 5.121540153915798,
“position_details”: {
“nft_metadata”: {
“title”: “Uniswap – 0.05% – cbETH/WETH – 0.95028<>0.95218”,
“description”: “This NFT represents a liquidity place in a Uniswap V3 cbETH-WETH pool.//…”,
“picture”: “//…”
},
//…
},
]
//…
}
With these three endpoints, you may acquire unparalleled perception into the DeFi positions of any pockets – all with a single API name!
Supported Protocols
The DeFi Positions function at present helps 13 main protocols, together with:
Uniswap-v3
Uniswap-v2
Pancakeswap-v3
Pancakeswap-v2
Quickswap-v2
Sushiswap-v2
Aave-v3
Aave-v2
Fraxswap-v2
Fraxswap-v1
Lido
Makerdao
Eigenlayer
That is only the start – our workforce at Moralis is constantly increasing assist by including new protocols regularly!
Tutorial: How you can Get DeFi Protocol Knowledge in 3 Steps
On this tutorial, we’ll information you thru the method of retrieving DeFi protocol information utilizing our DeFi API. And due to our user-friendly interface, you may obtain this in simply three easy steps:
Get a Moralis API Key
Write a Script Calling the getDefiSummary() Endpoint
Run the Code
However earlier than you get going, you should cope with a couple of stipulations!
Stipulations
If you happen to haven’t already, be sure you have the next prepared earlier than persevering with:
Step 1: Get a Moralis API Key
To get your key, first join with Moralis by clicking the ”Begin for Free” button on the high proper:
Subsequent, log in, and also you’ll discover your key instantly underneath the ”Residence” tab:
Copy and maintain the important thing for now, as you’ll want it through the second step.
Step 2: Write a Script Calling the getDefiSummary() Endpoint
Open your most well-liked built-in growth setting (IDE), arrange a folder, and initialize a brand new undertaking with the next terminal command:
npm init
Subsequent, run the command under to put in the required dependencies:
npm set up node-fetch –save
npm set up moralis @moralisweb3/common-evm-utils
Then, open your ”bundle.json” file and add “sort”: “module” to the checklist:
Create a brand new ”index.js” file and add the next script:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.builders.moralis.com/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/abstract?chain=eth’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Now, you should configure the code. Begin by changing YOUR_API_KEY with the important thing you copied throughout step one. Then, configure the deal with parameter to suit your question:
That’s it! All that continues to be is to execute the script.
Step 3: Run the Code
To execute the script, open a brand new terminal, navigate to your undertaking’s root folder, and run the next command:
node index.js
In return, you’ll obtain a abstract of the pockets’s DeFi positions. The response will embody the full USD worth of all positions, unclaimed rewards, protocol names, and extra. Right here’s an instance of what it would appear to be:
{
active_protocols: 8,
total_positions: 12,
total_usd_value: 871.6550972487607,
total_unclaimed_usd_value: 26.31655680118138,
protocols: [
{
protocol_name: ‘Uniswap v3’,
protocol_id: ‘uniswap-v3’,
protocol_url: ‘https://app.uniswap.org’,
protocol_logo: ‘https://cdn.developers.moralis.com/defi/uniswap.png’,
total_usd_value: 433.6700616074799,
total_unclaimed_usd_value: 26.31655680118138,
positions: 3
},
//…
]
}
Congratulations! You now know the way to seamlessly retrieve protocol information utilizing the Moralis DeFi API. You possibly can comply with the identical steps to name any of our different endpoints!
Advantages & Use Instances for DeFi Protocol Knowledge
Moralis’ DeFi Positions function presents versatile functions throughout numerous sectors. Listed here are 4 key examples:
Enhanced Portfolio Administration: Builders can elevate portfolio administration by integrating detailed DeFi exercise insights, driving increased person engagement and retention.
Complete Pockets Perception: Portfolio trackers can ship deeper visibility into customers’ DeFi actions, offering a extra full monetary overview.
Exact Tax Reporting: Crypto tax corporations can enhance reporting accuracy by leveraging complete DeFi protocol information.
Knowledgeable Funding Choices: DeFi-centric traders and analysts could make smarter buying and selling selections with granular DeFi protocol and place information.
In conclusion, our top-tier DeFi Positions function can come in useful when constructing a variety of dapps throughout a number of industries!
Past DeFi Positions – Exploring Moralis Additional
Moralis is the {industry}’s main Web3 information supplier, consolidating all crypto information in a single place. With our strong Web3 APIs and premium RPC nodes, accessing the info you want requires only a few traces of code. As such, whether or not you’re constructing a portfolio tracker, crypto tax device, or every other platform, Moralis has you coated.
What units our growth instruments aside?
Complete: Designed for effectivity, Moralis’ instruments offer you extra information with much less effort, permitting you to construct Web3 tasks sooner and extra successfully.
Cross-Chain Compatibility: Our Web3 APIs provide full function parity throughout 30+ blockchain networks, so you may depend on a single supplier for all of your information wants.
Enterprise-Grade Safety: As SOC 2 Kind 2 compliant, Moralis ensures enterprise-level information safety throughout all our merchandise.
Now that you’ve got an outline of Moralis, let’s dive into the specifics of our growth instruments under!
Web3 APIs
The Moralis Web3 API suite presents a complete set of instruments designed to streamline your developer expertise with seamless entry to blockchain information. Listed here are 5 key APIs:
Pockets API: Simplify pockets information integration with the Pockets API. Retrieve a pockets’s historical past, token balances, internet value, profitability, and extra with only a few traces of code.
Token API: Get ERC-20 token information effortlessly with the Moralis Token API. This interface gives seamless entry to token balances, metadata, costs, transactions, and extra, making it splendid for integrating ERC-20 information into wallets, portfolio trackers, and related platforms.
NFT API: The NFT API is your go-to answer for all issues NFT. Whether or not you want NFT balances, costs, or up-to-date metadata, this API delivers. It’s excellent for constructing NFT marketplaces, Web3 video games, and different NFT-centric functions.
Worth API: Fetch real-time and historic value information with Moralis’ Worth API. This highly effective device helps ERC-20 tokens and NFTs, making it straightforward to combine correct value information into your dapps.
Streams API: Keep forward with the Streams API, the industry-leading answer for real-time blockchain information. Our intuitive point-and-click interface enables you to arrange Web3 information pipelines effortlessly, so you may stream on-chain occasions instantly into your dapp as they occur.
Uncover extra about our cutting-edge APIs on the Moralis Web3 API web page.
RPC Nodes
Moralis’ node answer permits you to arrange RPC nodes for 30+ chains seamlessly with only a few clicks. Supported chains embody Ethereum, BSC, Base, Optimism, Polygon, and lots of extra. So, in the event you want nodes, be sure you take a look at Moralis’ RPC nodes!
Listed here are three key causes to decide on our nodes:
Dependable: Our nodes boast a formidable 99.9% uptime, making certain you get the info you want even when your dapp experiences downtime.
Quick: Moralis’ nodes set the benchmark for velocity with response instances as little as 70 ms.
Prolonged RPC Strategies: With our Prolonged RPC Strategies, you may question decoded information instantly out of your nodes – fetch ERC-20 token balances, metadata, native transactions, and rather more with single requests.
To be taught extra about how this works, please go to our RPC nodes web page!
Abstract: DeFi Protocol Knowledge – Exploring the Best Solution to Get a Pockets’s DeFi Positions
Cryptocurrency pockets holders usually lock up massive quantities of their property in DeFi protocols to earn yield. This makes monitoring DeFi positions essential for the monetary accuracy of crypto tax platforms, portfolio trackers, and related companies. Nevertheless, fetching a pockets’s DeFi positions has historically been a cumbersome activity. Happily, that is the place Moralis’ DeFi API comes into play!
The DeFi API is your go-to device for DeFi information. This premier interface presents a DeFi Positions function, permitting you to effortlessly question DeFi protocol information for any pockets. However what precisely does this entail? The DeFi Positions function gives three primary endpoints:
Abstract of DeFi Protocols by Pockets: Get a abstract of all DeFi protocols a pockets interacts with, together with the full USD worth locked throughout protocols, the variety of DeFi positions, and different protocol-specific particulars.
Abstract of DeFi Positions by Pockets: Get a abstract of all DeFi positions of a pockets, together with place labels, token varieties, the worth of every place, unclaimed rewards, and extra.
Detailed DeFi Positions by Pockets & Protocol: Fetch detailed place information for a given pockets and protocol, together with place labels, token varieties, costs, unclaimed rewards, and so on.
If you happen to discovered this text on DeFi protocol information useful, take a look at extra content material on the Moralis weblog. As an illustration, discover our information on the very best Alchemy Customized Webhooks different or learn to use our Crypto PnL API.
Able to dive into DeFi protocol information? Enroll with Moralis without spending a dime and get prompt entry to our APIs and RPC nodes!
