defillama-sdk 0.1.0__py3-none-any.whl

defillama_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,688 @@
+Metadata-Version: 2.4
+Name: defillama-sdk
+Version: 0.1.0
+Summary: Python SDK for DefiLlama API
+Author: DefiLlama
+Project-URL: Homepage, https://api-docs.defillama.com/
+Project-URL: Repository, https://github.com/DefiLlama/python-sdk
+Keywords: defillama,defi,tvl,cryptocurrency,api,sdk
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# DefiLlama Python SDK
+
+Official Python SDK for the [DefiLlama API](https://api-docs.defillama.com/). Access DeFi protocol data including TVL, prices, yields, volumes, fees, bridges, and more.
+
+## Installation
+
+```bash
+pip install defillama-sdk
+```
+
+```bash
+uv pip install defillama-sdk
+```
+
+## Quick Start
+
+```python
+from defillama_api import DefiLlama
+
+# Free tier
+client = DefiLlama()
+
+# Pro tier (required for premium endpoints)
+pro_client = DefiLlama({"api_key": "your-api-key"})
+
+# Get all protocols
+protocols = client.tvl.getProtocols()
+
+# Get current token prices
+prices = client.prices.getCurrentPrices(
+    [
+        "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        "coingecko:bitcoin",
+    ]
+)
+```
+
+## Configuration
+
+```python
+config = {
+    "api_key": "your-api-key",
+    "timeout": 30000,
+}
+
+client = DefiLlama(config)
+```
+
+## Modules
+
+- TVL
+- Prices
+- Stablecoins
+- Yields (Pro)
+- Volumes
+- Fees
+- Emissions (Pro)
+- Bridges (Pro)
+- Ecosystem (Pro)
+- ETFs (Pro)
+- DAT (Pro)
+- Account (Pro)
+
+🔐 = Requires Pro API key
+
+---
+
+## TVL
+
+Total Value Locked data for protocols and chains.
+
+### getProtocols
+
+Get all protocols with current TVL.
+
+```python
+protocols = client.tvl.getProtocols()
+```
+
+### getProtocol
+
+Get detailed protocol information including historical TVL.
+
+```python
+aave = client.tvl.getProtocol("aave")
+```
+
+### getTvl
+
+Get only current TVL for a protocol.
+
+```python
+tvl = client.tvl.getTvl("uniswap")
+```
+
+### getChains
+
+Get current TVL for all chains.
+
+```python
+chains = client.tvl.getChains()
+```
+
+### getHistoricalChainTvl
+
+Get historical TVL data.
+
+```python
+all_history = client.tvl.getHistoricalChainTvl()
+eth_history = client.tvl.getHistoricalChainTvl("Ethereum")
+```
+
+### getTokenProtocols 🔐
+
+Get protocols holding a specific token.
+
+```python
+holders = pro_client.tvl.getTokenProtocols("ETH")
+```
+
+### getInflows 🔐
+
+Get token inflows/outflows between timestamps.
+
+```python
+inflows = pro_client.tvl.getInflows(
+    "lido",
+    1704067200,
+    1704153600,
+    "ETH,USDC",
+)
+```
+
+### getChainAssets 🔐
+
+Get asset breakdown for all chains.
+
+```python
+assets = pro_client.tvl.getChainAssets()
+```
+
+---
+
+## Prices
+
+Token price data and historical charts.
+
+### getCurrentPrices
+
+```python
+prices = client.prices.getCurrentPrices(
+    [
+        "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        "coingecko:bitcoin",
+        "solana:So11111111111111111111111111111111111111112",
+    ]
+)
+```
+
+### getHistoricalPrices
+
+```python
+prices = client.prices.getHistoricalPrices(
+    1704067200,
+    ["ethereum:0xdac17f958d2ee523a2206206994597c13d831ec7"],
+)
+```
+
+### getBatchHistoricalPrices
+
+```python
+prices = client.prices.getBatchHistoricalPrices(
+    {
+        "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": [
+            1704067200,
+            1704153600,
+            1704240000,
+        ]
+    }
+)
+```
+
+### getChart
+
+```python
+chart = client.prices.getChart(
+    ["coingecko:ethereum"],
+    {"start": 1704067200, "period": "1d", "span": 30},
+)
+```
+
+### getPercentageChange
+
+```python
+change = client.prices.getPercentageChange(
+    ["coingecko:bitcoin"],
+    {"period": "24h"},
+)
+```
+
+### getFirstPrices
+
+```python
+first = client.prices.getFirstPrices(
+    ["ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]
+)
+```
+
+### getBlockAtTimestamp
+
+```python
+block = client.prices.getBlockAtTimestamp("ethereum", 1704067200)
+```
+
+---
+
+## Stablecoins
+
+Stablecoin market cap and dominance data.
+
+### getStablecoins
+
+```python
+stables = client.stablecoins.getStablecoins(True)
+```
+
+### getAllCharts
+
+```python
+charts = client.stablecoins.getAllCharts()
+```
+
+### getChartsByChain
+
+```python
+eth_charts = client.stablecoins.getChartsByChain("Ethereum")
+```
+
+### getStablecoin
+
+```python
+usdt = client.stablecoins.getStablecoin("1")
+```
+
+### getChains
+
+```python
+chains = client.stablecoins.getChains()
+```
+
+### getPrices
+
+```python
+prices = client.stablecoins.getPrices()
+```
+
+### getDominance 🔐
+
+```python
+dominance = pro_client.stablecoins.getDominance("ethereum", 1)
+```
+
+---
+
+## Yields 🔐
+
+Yield farming, lending, staking, and perpetual funding rates.
+
+### getPools
+
+```python
+pools = pro_client.yields.getPools()
+```
+
+### getPoolsOld
+
+```python
+pools = pro_client.yields.getPoolsOld()
+```
+
+### getPoolChart
+
+```python
+chart = pro_client.yields.getPoolChart("pool-uuid-here")
+```
+
+### getBorrowPools
+
+```python
+borrow_pools = pro_client.yields.getBorrowPools()
+```
+
+### getLendBorrowChart
+
+```python
+chart = pro_client.yields.getLendBorrowChart("pool-uuid-here")
+```
+
+### getPerps
+
+```python
+perps = pro_client.yields.getPerps()
+```
+
+### getLsdRates
+
+```python
+lsd_rates = pro_client.yields.getLsdRates()
+```
+
+---
+
+## Volumes
+
+DEX, options, and derivatives trading volume data.
+
+### getDexOverview
+
+```python
+overview = client.volumes.getDexOverview()
+overview = client.volumes.getDexOverview(
+    {"excludeTotalDataChart": True, "dataType": "dailyVolume"}
+)
+```
+
+### getDexOverviewByChain
+
+```python
+eth_volume = client.volumes.getDexOverviewByChain("Ethereum")
+```
+
+### getDexSummary
+
+```python
+uniswap = client.volumes.getDexSummary("uniswap")
+```
+
+### getOptionsOverview
+
+```python
+options = client.volumes.getOptionsOverview()
+```
+
+### getOptionsOverviewByChain
+
+```python
+eth_options = client.volumes.getOptionsOverviewByChain("Ethereum")
+```
+
+### getOptionsSummary
+
+```python
+derive = client.volumes.getOptionsSummary("derive")
+```
+
+### getDerivativesOverview 🔐
+
+```python
+derivatives = pro_client.volumes.getDerivativesOverview()
+```
+
+### getDerivativesSummary 🔐
+
+```python
+gmx = pro_client.volumes.getDerivativesSummary("gmx")
+```
+
+---
+
+## Fees
+
+Protocol fees and revenue data.
+
+### Fee Data Types
+
+```python
+from defillama_api import FeeDataType
+
+FeeDataType.DAILY_FEES
+FeeDataType.DAILY_REVENUE
+FeeDataType.DAILY_HOLDERS_REVENUE
+FeeDataType.DAILY_SUPPLY_SIDE_REVENUE
+FeeDataType.DAILY_BRIBES_REVENUE
+FeeDataType.DAILY_TOKEN_TAXES
+FeeDataType.DAILY_APP_FEES
+FeeDataType.DAILY_APP_REVENUE
+FeeDataType.DAILY_EARNINGS
+```
+
+### getOverview
+
+```python
+fees = client.fees.getOverview()
+revenue = client.fees.getOverview({"dataType": FeeDataType.DAILY_REVENUE})
+```
+
+### getOverviewByChain
+
+```python
+eth_fees = client.fees.getOverviewByChain("Ethereum")
+```
+
+### getSummary
+
+```python
+uniswap_fees = client.fees.getSummary("uniswap")
+```
+
+### getChart 🔐
+
+```python
+chart = pro_client.fees.getChart()
+eth_chart = pro_client.fees.getChartByChain("Ethereum")
+protocol_chart = pro_client.fees.getChartByProtocol("aave")
+```
+
+### getChartByProtocolChainBreakdown 🔐
+
+```python
+breakdown = pro_client.fees.getChartByProtocolChainBreakdown("aave")
+```
+
+### getChartByProtocolVersionBreakdown 🔐
+
+```python
+breakdown = pro_client.fees.getChartByProtocolVersionBreakdown("uniswap")
+```
+
+### getChartByChainProtocolBreakdown 🔐
+
+```python
+breakdown = pro_client.fees.getChartByChainProtocolBreakdown("Ethereum")
+```
+
+### getChartChainBreakdown 🔐
+
+```python
+breakdown = pro_client.fees.getChartChainBreakdown()
+```
+
+### getMetrics 🔐
+
+```python
+metrics = pro_client.fees.getMetrics()
+chain_metrics = pro_client.fees.getMetricsByChain("Ethereum")
+protocol_metrics = pro_client.fees.getMetricsByProtocol("aave")
+```
+
+---
+
+## Emissions 🔐
+
+Token unlock schedules and vesting data.
+
+### getAll
+
+```python
+emissions = pro_client.emissions.getAll()
+```
+
+### getByProtocol
+
+```python
+arbitrum = pro_client.emissions.getByProtocol("arbitrum")
+```
+
+---
+
+## Bridges 🔐
+
+Cross-chain bridge volume and transaction data.
+
+### getAll
+
+```python
+bridges = pro_client.bridges.getAll()
+bridges = pro_client.bridges.getAll({"includeChains": True})
+```
+
+### getById
+
+```python
+bridge = pro_client.bridges.getById(1)
+```
+
+### getVolumeByChain
+
+```python
+volume = pro_client.bridges.getVolumeByChain("Ethereum")
+```
+
+### getDayStats
+
+```python
+stats = pro_client.bridges.getDayStats(1704067200, "Ethereum")
+```
+
+### getTransactions
+
+```python
+txs = pro_client.bridges.getTransactions(
+    1,
+    {
+        "limit": 100,
+        "startTimestamp": 1704067200,
+        "endTimestamp": 1704153600,
+        "sourceChain": "Ethereum",
+        "address": "0x...",
+    },
+)
+```
+
+---
+
+## Ecosystem 🔐
+
+Ecosystem-level data.
+
+### getCategories
+
+```python
+categories = pro_client.ecosystem.getCategories()
+```
+
+### getForks
+
+```python
+forks = pro_client.ecosystem.getForks()
+```
+
+### getOracles
+
+```python
+oracles = pro_client.ecosystem.getOracles()
+```
+
+### getEntities
+
+```python
+entities = pro_client.ecosystem.getEntities()
+```
+
+### getTreasuries
+
+```python
+treasuries = pro_client.ecosystem.getTreasuries()
+```
+
+### getHacks
+
+```python
+hacks = pro_client.ecosystem.getHacks()
+```
+
+### getRaises
+
+```python
+raises = pro_client.ecosystem.getRaises()
+```
+
+---
+
+## ETFs 🔐
+
+Bitcoin and Ethereum ETF data.
+
+### getOverview
+
+```python
+btc_etfs = pro_client.etfs.getOverview()
+```
+
+### getOverviewEth
+
+```python
+eth_etfs = pro_client.etfs.getOverviewEth()
+```
+
+### getHistory
+
+```python
+history = pro_client.etfs.getHistory()
+```
+
+### getHistoryEth
+
+```python
+history_eth = pro_client.etfs.getHistoryEth()
+```
+
+### getFdvPerformance
+
+```python
+perf = pro_client.etfs.getFdvPerformance("30")
+```
+
+---
+
+## DAT 🔐
+
+Digital Asset Treasury data and institutional holdings.
+
+### getInstitutions
+
+```python
+data = pro_client.dat.getInstitutions()
+```
+
+### getInstitution
+
+```python
+mstr = pro_client.dat.getInstitution("MSTR")
+```
+
+---
+
+## Account 🔐
+
+API usage management.
+
+### getUsage
+
+```python
+usage = pro_client.account.getUsage()
+```
+
+---
+
+## Error Handling
+
+```python
+from defillama_api import ApiKeyRequiredError, RateLimitError, NotFoundError, ApiError
+
+try:
+    data = pro_client.yields.getPools()
+except ApiKeyRequiredError:
+    print("Pro API key required for this endpoint")
+except RateLimitError as exc:
+    print(f"Rate limited. Retry after {exc.retry_after} seconds")
+except NotFoundError:
+    print("Resource not found")
+except ApiError as exc:
+    print(f"API error: {exc.status_code}")
+```
+
+---
+
+## Type Exports
+
+All types are available from `defillama_api.types`, and are re-exported at the top level:
+
+```python
+from defillama_api import Protocol, CoinPricesResponse, Stablecoin, YieldPool
+```
+
+---
+
+## Constants
+
+```python
+from defillama_api import AdapterType, FeeDataType, VolumeDataType
+
+AdapterType.DEXS
+VolumeDataType.DAILY_VOLUME
+FeeDataType.DAILY_FEES
+```
+
+---
+
+## Requirements
+
+- Python >= 3.9
+
+## License
+
+MIT

defillama_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+defillama_api/__init__.py,sha256=I_Xbp5e4Dt3QozmepJ6uGwS3mQOEiEbVzp6f9THObNU,2161
+defillama_api/client.py,sha256=YducXxdZefwp2WnGUkL-OAZhhrm-C8-qZfC0YIw1sWs,4965
+defillama_api/errors.py,sha256=m7gqX_ri0pm9QSQVkCgCHn8cYz3OmOdhuOXOdkifnvM,1209
+defillama_api/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+defillama_api/constants/__init__.py,sha256=mm_zBSoTOmb8pQ3YK8Ji9Xo7qX_M5ZYbVA_K5XgS7F0,273
+defillama_api/constants/dimensions.py,sha256=XPBP2J-ILFD2E_slf-h3xo7jwtPl4K2Ugf836fWiHSM,1887
+defillama_api/modules/__init__.py,sha256=Wmo-k2cAlX1Kz2CBYYnmWJiBRKtJ5Bf12qk2QBj47Eo,708
+defillama_api/modules/account.py,sha256=Gz-FDyRTaz4lMtTGdTDLl4UDXR1oiuCSCsRS9_CIW6E,901
+defillama_api/modules/bridges.py,sha256=CSfSZQYsSlwEeLnr-Tkz6CZVQM8nZoKvQUQPKsceuRE,2567
+defillama_api/modules/dat.py,sha256=XbIoeljsJZIknRn2s4uMxsq-6M-GDHmOBc38z5a0mBM,884
+defillama_api/modules/ecosystem.py,sha256=NvFO7h2i4Hb2emNAJ_zYNuRUgcqn_m6D-GImDj6hwiY,1518
+defillama_api/modules/emissions.py,sha256=SrJ2E7zzRAduJIf-YXtVqJxgqcziGRWvtx3B4A1e5QI,926
+defillama_api/modules/etfs.py,sha256=F4HrzAQdd2aFreuL8KCbJnQWJ11cjlUG1oSRpq8d2W4,1535
+defillama_api/modules/fees.py,sha256=pmKxX5x8frrHFTdChAqSdmGCFwciRixsgR3PhTTOtRg,8267
+defillama_api/modules/prices.py,sha256=Cq0ZRTXMdpUteUhopZBWQNqkNf_jiJY2YldRuuViJhQ,3675
+defillama_api/modules/stablecoins.py,sha256=TT8IDv0GSLhDqi0NVD9j6GwCo7fidISO2TfEoWPtkOQ,2463
+defillama_api/modules/tvl.py,sha256=TRyv0VHg_JpBdtWSpW87vJcuB0EDDHzOJSvkXPXz-RQ,2454
+defillama_api/modules/volumes.py,sha256=pawVOPF4KWbTqBCY_Fz4pLUIP1sGUPhDI0xGRE1VRm4,4049
+defillama_api/modules/yields.py,sha256=tWgOBgRbw8qtyET22wo8o3umtvbwyKYoojfY8HkMHrk,2178
+defillama_api/types/__init__.py,sha256=vD04wPPb58zcvh1BYUcTUifkoqgyy-LRIl8Lm7Z4xkM,317
+defillama_api/types/account.py,sha256=BBGOvn3L7WxhGfAWyffc7fqNP1ZbJvWDMHV21UtWrTk,147
+defillama_api/types/bridges.py,sha256=6GcIDLsyRUqorKsPCgKktoaBm0nEF-KlBydvF3KnvP4,3421
+defillama_api/types/dat.py,sha256=_qdpI33t6h4HC-o9FB6cI43t37mA9ngyqKm9_yKNY8o,3899
+defillama_api/types/ecosystem.py,sha256=9RHnpOueJgvrJz8U0uSAv0m7Xh2JvdkanXp5q6ofjs8,4471
+defillama_api/types/emissions.py,sha256=rijfVlkV9PMVbIn2UsV69-wmoWs-ZLE8Wb1XhEEKoYE,3398
+defillama_api/types/etfs.py,sha256=wJOjd1cD3-_CN0BrEeXPnqXVlbN5uIqzoQ6OhhXbpdo,577
+defillama_api/types/fees.py,sha256=ePqqzSmvXqazC4e-KCIouvQeRZpePnTEthQzeTxN5EU,5886
+defillama_api/types/prices.py,sha256=qot5ESoMHZkLgL6sTg_FaEfY62eed2H-SXXAbKM2B30,1974
+defillama_api/types/stablecoins.py,sha256=SfCVOIogu88JdONekzSJrPIno2v-EYDDoBPBYZP_vM4,3965
+defillama_api/types/tvl.py,sha256=XOsSzVCNpDy3VEbX33vo7qAUv7lokdB9Q7KU5RNKd0k,4530
+defillama_api/types/volumes.py,sha256=VJ14YepNzbayY-jsarbv_jIopnxl2bbWPqldo9TZAUs,4293
+defillama_api/types/yields.py,sha256=rpuAzxLBy4QO42EtUYDXS-sbq4AqoND9YfePYXLg7Tc,3978
+defillama_sdk-0.1.0.dist-info/METADATA,sha256=-SMOI1et3HZ5Cqh3pQr-6EUoyzejVhSW73sheOjdlL4,10781
+defillama_sdk-0.1.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+defillama_sdk-0.1.0.dist-info/top_level.txt,sha256=vZ6lunBg1x-WPWjQcH_obfCDY2P8kLmhAUfgSb9UFnQ,14
+defillama_sdk-0.1.0.dist-info/RECORD,,

defillama_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

defillama_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+defillama_api