Skip to content

Commit 181f964

Browse files
treeoflife2treeoflife2
authored
Merge pull request #4 from DefiLlama/update-etf-endpoints
update etf endpoints
2 parents 73aa4d2 + d6b0589 commit 181f964

File tree

1 file changed

+30
-282
lines changed

1 file changed

+30
-282
lines changed

‎defillama-openapi-pro.json‎

Lines changed: 30 additions & 282 deletions
Original file line numberDiff line numberDiff line change
@@ -2659,10 +2659,10 @@
26592659
"x-pro-only": true
26602660
}
26612661
},
2662-
"/etfs/overview": {
2662+
"/etfs/snapshot": {
26632663
"get": {
26642664
"tags": ["ETFs"],
2665-
"summary": "Get BTC ETFs and their metrics (aum, price, fees...)",
2665+
"summary": "Get ETFs and their metrics (aum, flows, fees...)",
26662666
"responses": {
26672667
"200": {
26682668
"description": "successful operation",
@@ -2673,17 +2673,17 @@
26732673
"items": {
26742674
"type": "object",
26752675
"properties": {
2676+
"ticker": {
2677+
"type": "string",
2678+
"description": "ETF ticker symbol"
2679+
},
26762680
"timestamp": {
26772681
"type": "integer",
26782682
"description": "Current timestamp"
26792683
},
2680-
"timestamp_as_of": {
2681-
"type": "integer",
2682-
"description": "Timestamp as of date"
2683-
},
2684-
"ticker": {
2684+
"asset": {
26852685
"type": "string",
2686-
"description": "ETF ticker symbol"
2686+
"description": "Asset name"
26872687
},
26882688
"issuer": {
26892689
"type": "string",
@@ -2693,10 +2693,6 @@
26932693
"type": "string",
26942694
"description": "Full ETF name"
26952695
},
2696-
"etf_type": {
2697-
"type": "string",
2698-
"description": "Type of ETF (e.g., spot)"
2699-
},
27002696
"custodian": {
27012697
"type": "string",
27022698
"description": "Custodian name"
@@ -2709,166 +2705,35 @@
27092705
"type": "string",
27102706
"description": "ETF URL"
27112707
},
2712-
"price": {
2713-
"type": "number",
2714-
"description": "Current price"
2715-
},
2716-
"volume": {
2717-
"type": "number",
2718-
"description": "Trading volume"
2719-
},
2720-
"shares": {
2721-
"type": "integer",
2722-
"description": "Number of shares"
2723-
},
2724-
"underlying": {
2725-
"type": "number",
2726-
"nullable": true,
2727-
"description": "Underlying asset amount"
2728-
},
2729-
"underlying_price": {
2708+
"flows": {
27302709
"type": "number",
2731-
"description": "Underlying asset price"
2710+
"description": "Net flows"
27322711
},
27332712
"aum": {
27342713
"type": "number",
27352714
"description": "Assets under management"
27362715
},
2737-
"flows": {
2716+
"volume": {
27382717
"type": "number",
2739-
"description": "Net flows"
2718+
"description": "Trading volume"
27402719
}
27412720
}
27422721
}
27432722
},
27442723
"example": [
27452724
{
2746-
"timestamp": 1732278611,
2747-
"timestamp_as_of": 1732147200,
27482725
"ticker": "IBIT",
2726+
"timestamp": 1755612389,
2727+
"asset": "bitcoin",
27492728
"issuer": "Blackrock",
27502729
"etf_name": "iShares Bitcoin Trust",
2751-
"etf_type": "spot",
27522730
"custodian": "Coinbase",
27532731
"pct_fee": 0.25,
27542732
"url": "https://www.blackrock.com/us/individual/products/333011/ishares-bitcoin-trust",
2755-
"price": 55.9,
2756-
"volume": 5105037034.5,
2757-
"shares": 846080000,
2758-
"underlying": null,
2759-
"underlying_price": 98855,
2760-
"aum": 47313346647,
2761-
"flows": 645378400
2762-
}
2763-
]
2764-
}
2765-
}
2766-
}
2767-
},
2768-
"x-pro-only": true
2769-
}
2770-
},
2771-
"/etfs/overviewEth": {
2772-
"get": {
2773-
"tags": ["ETFs"],
2774-
"summary": "Get ETH ETFs",
2775-
"responses": {
2776-
"200": {
2777-
"description": "successful operation",
2778-
"content": {
2779-
"application/json": {
2780-
"schema": {
2781-
"type": "array",
2782-
"items": {
2783-
"type": "object",
2784-
"properties": {
2785-
"timestamp": {
2786-
"type": "integer",
2787-
"description": "Current timestamp"
2788-
},
2789-
"timestamp_as_of": {
2790-
"type": "integer",
2791-
"description": "Timestamp as of date"
2792-
},
2793-
"ticker": {
2794-
"type": "string",
2795-
"description": "ETF ticker symbol"
2796-
},
2797-
"issuer": {
2798-
"type": "string",
2799-
"description": "ETF issuer name"
2800-
},
2801-
"etf_name": {
2802-
"type": "string",
2803-
"description": "Full ETF name"
2804-
},
2805-
"etf_type": {
2806-
"type": "string",
2807-
"description": "Type of ETF (e.g., spot)"
2808-
},
2809-
"custodian": {
2810-
"type": "string",
2811-
"description": "Custodian name"
2812-
},
2813-
"pct_fee": {
2814-
"type": "number",
2815-
"description": "Percentage fee"
2816-
},
2817-
"url": {
2818-
"type": "string",
2819-
"description": "ETF URL"
2820-
},
2821-
"price": {
2822-
"type": "number",
2823-
"description": "Current price"
2824-
},
2825-
"volume": {
2826-
"type": "number",
2827-
"description": "Trading volume"
2828-
},
2829-
"shares": {
2830-
"type": "integer",
2831-
"description": "Number of shares"
2832-
},
2833-
"underlying": {
2834-
"type": "number",
2835-
"nullable": true,
2836-
"description": "Underlying asset amount"
2837-
},
2838-
"underlying_price": {
2839-
"type": "number",
2840-
"description": "Underlying asset price"
2841-
},
2842-
"aum": {
2843-
"type": "number",
2844-
"description": "Assets under management"
2845-
},
2846-
"flows": {
2847-
"type": "number",
2848-
"description": "Net flows"
2849-
}
2850-
}
2851-
}
2852-
},
2853-
"example": [
2854-
{
2855-
"timestamp": 1732278617,
2856-
"timestamp_as_of": 1732147200,
2857-
"ticker": "ETHE",
2858-
"issuer": "Grayscale",
2859-
"etf_name": "Grayscale Ethereum Trust",
2860-
"etf_type": "spot",
2861-
"custodian": "Coinbase",
2862-
"pct_fee": 2.5,
2863-
"url": "https://etfs.grayscale.com/ethe",
2864-
"price": 28.18,
2865-
"volume": 182128523.56,
2866-
"shares": 180448500,
2867-
"underlying": 1517091.9224,
2868-
"underlying_price": 3352.05,
2869-
"aum": 5089266904.78,
2870-
"flows": 0
2871-
}
2733+
"flows": -68700000,
2734+
"aum": 87276718199,
2735+
"volume": 453293317.84999996
2736+
}
28722737
]
28732738
}
28742739
}
@@ -2877,10 +2742,10 @@
28772742
"x-pro-only": true
28782743
}
28792744
},
2880-
"/etfs/history": {
2745+
"/etfs/flows": {
28812746
"get": {
28822747
"tags": ["ETFs"],
2883-
"summary": "Historical AUM of all BTC ETFs",
2748+
"summary": "Historical Flows at the Asset Level",
28842749
"responses": {
28852750
"200": {
28862751
"description": "successful operation",
@@ -2891,144 +2756,27 @@
28912756
"items": {
28922757
"type": "object",
28932758
"properties": {
2894-
"timestamp": {
2895-
"type": "integer",
2896-
"description": "Timestamp"
2897-
},
2898-
"timestamp_exact": {
2899-
"type": "integer",
2900-
"description": "Exact timestamp"
2901-
},
2902-
"ticker": {
2759+
"gecko_id": {
29032760
"type": "string",
2904-
"description": "ETF ticker symbol"
2905-
},
2906-
"price": {
2907-
"type": "number",
2908-
"description": "Price at timestamp"
2761+
"description": "CoinGecko ID"
29092762
},
2910-
"volume": {
2911-
"type": "number",
2912-
"description": "Volume at timestamp"
2913-
},
2914-
"aum": {
2915-
"type": "number",
2916-
"description": "Assets under management at timestamp"
2917-
},
2918-
"underlying": {
2919-
"type": "number",
2920-
"nullable": true,
2921-
"description": "Underlying asset amount"
2922-
},
2923-
"shares": {
2924-
"type": "number",
2925-
"description": "Number of shares"
2926-
},
2927-
"underlying_price": {
2928-
"type": "number",
2929-
"description": "Underlying asset price"
2930-
},
2931-
"flows": {
2932-
"type": "number",
2933-
"nullable": true,
2934-
"description": "Net flows"
2935-
}
2936-
}
2937-
}
2938-
},
2939-
"example": [
2940-
{
2941-
"timestamp": 1704931200,
2942-
"timestamp_exact": 1705017598,
2943-
"ticker": "ARKB",
2944-
"price": 46.76,
2945-
"volume": 279749462.16,
2946-
"aum": 46855730.4,
2947-
"underlying": null,
2948-
"shares": 1002047.271171942,
2949-
"underlying_price": 46396,
2950-
"flows": null
2951-
}
2952-
]
2953-
}
2954-
}
2955-
}
2956-
},
2957-
"x-pro-only": true
2958-
}
2959-
},
2960-
"/etfs/historyEth": {
2961-
"get": {
2962-
"tags": ["ETFs"],
2963-
"summary": "Historical AUM of all BTC ETFs",
2964-
"responses": {
2965-
"200": {
2966-
"description": "successful operation",
2967-
"content": {
2968-
"application/json": {
2969-
"schema": {
2970-
"type": "array",
2971-
"items": {
2972-
"type": "object",
2973-
"properties": {
2974-
"timestamp": {
2975-
"type": "integer",
2976-
"description": "Timestamp"
2977-
},
2978-
"timestamp_exact": {
2979-
"type": "integer",
2980-
"description": "Exact timestamp"
2981-
},
2982-
"ticker": {
2763+
"day": {
29832764
"type": "string",
2984-
"description": "ETF ticker symbol"
2985-
},
2986-
"price": {
2987-
"type": "number",
2988-
"description": "Price at timestamp"
2989-
},
2990-
"volume": {
2991-
"type": "number",
2992-
"description": "Volume at timestamp"
2993-
},
2994-
"aum": {
2995-
"type": "number",
2996-
"description": "Assets under management at timestamp"
2765+
"description": "Day"
29972766
},
2998-
"underlying": {
2767+
"total_flow_usd": {
29992768
"type": "number",
3000-
"nullable": true,
3001-
"description": "Underlying asset amount"
3002-
},
3003-
"shares": {
3004-
"type": "number",
3005-
"description": "Number of shares"
3006-
},
3007-
"underlying_price": {
3008-
"type": "number",
3009-
"description": "Underlying asset price"
3010-
},
3011-
"flows": {
3012-
"type": "number",
3013-
"nullable": true,
3014-
"description": "Net flows"
2769+
"description": "Sum of all USD flows per asset"
30152770
}
30162771
}
30172772
}
30182773
},
30192774
"example": [
30202775
{
3021-
"timestamp": 1721779200,
3022-
"timestamp_exact": 1721865445,
3023-
"ticker": "ETHA",
3024-
"price": 25.5,
3025-
"volume": 255655477.5,
3026-
"aum": 269883322,
3027-
"underlying": null,
3028-
"shares": 10520000,
3029-
"underlying_price": 3336.28,
3030-
"flows": 16326800
3031-
}
2776+
"gecko_id": "bitcoin",
2777+
"day": "2024-01-11T00:00:00.000Z",
2778+
"total_flow_usd": 655300000
2779+
}
30322780
]
30332781
}
30342782
}

0 commit comments

Comments
 (0)