{"node":{"id":"b0b0c504-fdb0-4f5e-b9dd-8eca3f3438b1","handle":"b0b0","type":"note","intent":null,"title":"Derivatives positioning — the eight futures endpoints","aiSummary":"The eight Binance futures API endpoints for derivatives positioning: open interest (current and historical), funding rate (current and history), three long/short ratios (all accounts, top accounts by headcount, top accounts by dollar weight), and taker aggression. Each endpoint explained with its URL, parameters, what the response means, and how to read the numbers.","content":"# Derivatives positioning — the eight futures endpoints\n\nAll calls go to `https://fapi.binance.com`. All are single GET requests, no pagination needed. All return JSON.\n\n## 1. Current price + funding rate\n\n`GET /fapi/v1/premiumIndex?symbol=ZECUSDT`\n\nReturns `markPrice` (the current mark price) and `lastFundingRate` (what longs pay shorts every 8 hours, as a decimal — multiply by 100 for percent). Positive = longs pay shorts. Negative = shorts pay longs. Annualise: rate × 3 × 365 × 100.\n\n## 2. Current open interest\n\n`GET /fapi/v1/openInterest?symbol=ZECUSDT`\n\nReturns `openInterest` in coins. Multiply by mark price for dollar value. OI going up = new positions opening. OI going down = positions closing. OI is not directional — it counts both sides.\n\n## 3. Open interest history\n\n`GET /futures/data/openInterestHist?symbol=ZECUSDT&period=1h&limit=24`\n\nReturns `sumOpenInterestValue` (already in USD) over time. Periods: `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `1d`. Shows the trend — is money flowing in or out?\n\n## 4. All-accounts long/short ratio\n\n`GET /futures/data/globalLongShortAccountRatio?symbol=ZECUSDT&period=1d&limit=8`\n\nReturns `longShortRatio` — the ratio of long accounts to short accounts. Every account gets one vote regardless of position size. Below 1.0 = more accounts are short. At 0.44, that means 69% of accounts are short. This is crowd sentiment.\n\n## 5. Top-accounts long/short ratio (by headcount)\n\n`GET /futures/data/topLongShortAccountRatio?symbol=ZECUSDT&period=1d&limit=8`\n\nSame as above but only the top 20% of accounts by margin balance. One vote each. Shows whether richer traders lean the same way as the crowd or differently.\n\n## 6. Top-positions long/short ratio (by dollar weight)\n\n`GET /futures/data/topLongShortPositionRatio?symbol=ZECUSDT&period=1d&limit=8`\n\nTop 20% by margin balance, weighted by actual position size. This is where the money actually sits. The gap between this number and the headcount ratio (#5) tells you whether large traders have big positions or small ones.\n\n## 7. Taker buy/sell ratio\n\n`GET /futures/data/takerlongshortRatio?symbol=ZECUSDT&period=1d&limit=7`\n\nReturns `buySellRatio` — taker buy volume divided by taker sell volume. Above 1.0 = buyers are the aggressive side (lifting asks). Below 1.0 = sellers are hitting bids. Also returns raw `buyVol` and `sellVol`. Periods: `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `1d`.\n\n## 8. Funding rate history\n\n`GET /fapi/v1/fundingRate?symbol=ZECUSDT&limit=21`\n\nReturns the last N funding rate snapshots (every 8 hours). 21 periods = 7 days. Take the mean and annualise to see the trend. Persistently positive = longs are paying a premium (bullish positioning). Negative = shorts are paying (bearish positioning but also squeeze fuel).\n\n## How to read the numbers together\n\n- **OI rising + L/S falling below 1.0** = shorts are piling in. If price holds or rises, that is squeeze fuel.\n- **OI rising + L/S rising above 1.0** = longs are piling in. If price stalls, that is long liquidation fuel.\n- **OI falling** = people are leaving, regardless of direction. The trade is unwinding.\n- **Funding negative + price rising** = shorts are paying to stay wrong. Time pressure is on them.\n- **Taker ratio persistently above 1.0** = buyers are the aggressive side on the tape. Below 1.0 = sellers.\n- **Top-positions vs top-accounts gap** = if top-accounts L/S is 0.40 (many small shorts) but top-positions is 0.90 (dollars nearly balanced), the shorts are small bets, not large convictions.\n\n## Symbol note\n\nMost coins use the same ticker on spot and futures (e.g., `ZECUSDT`). PEPE is the exception — futures use `1000PEPEUSDT` (denominated in units of 1,000 PEPE).","capturedAt":"2026-09-05T00:25:18.947Z","createdAt":"2026-09-05T00:25:18.948Z","updatedAt":"2026-09-05T00:27:50.306Z","spanId":null,"contributor":null,"audiences":[{"kind":"public","createdAt":"2026-09-05T00:26:56.041Z"}],"fingerprint":"ae7ce16a7353f761cfa5ad19b844b8cd2a8c5e7c6292b982f6217a03447e4956","revisionNo":"1","structureHash":"35fae151a19c0fc49c43520f5c9aa684c80a328712ee2872fb60ef2264af10de"},"links":[{"direction":"in","verb":"references","reason":"only if you need futures positioning data — open interest, funding, long/short ratios, taker aggression","hash":"d937ec54fd86dcdb455ef4968c4874db3ef39306283801fb2a62f486f8705130","node":{"id":"7a910307-b832-453e-a51c-6d414c4833a0","handle":"7a91","type":"note","title":"Binance crypto data — spot cohorts and derivatives positioning","aiSummary":"A self-contained recipe for pulling crypto market data from Binance's public API: spot trade cohort analysis (who is buying/selling by trade size) and derivatives positioning (open interest, funding, long/short ratios). No API key needed. Geo-blocked from AU/US — works from Singapore or Hong Kong.","erased":false,"href":"https://lattris.com/api/lattris/by/b/memories/7a910307-b832-453e-a51c-6d414c4833a0?links=1","fingerprint":"83ac4eb9e3a959967b369b91741f5da82a6afca6f5eddf0d7b4564ac9227525f","revisionNo":"1","structureHash":"3c69f746e1b682f6dcd24be2f3cf4939a1bd834a70a053fb74bfd4bdff8683d7","intent":"recipe"}}],"dictionary":{"lattris":"A personal knowledge base — how a person captures what they know as linked blocks they own and control. To understand how this knowledge base works: https://lattris.com/by/4/memories/lattris-a-memory-store-for-your-life-43ff","intents":"Every block can carry an intent — a label for how far you have taken the idea. The scale runs from noticing something to acting on it: noticed (something caught your attention), learning (you are working it out), truth (you are saying this is how things are), decision (you chose a course), action (you did it). Recipe sits outside that scale — it is not a stronger claim, it is a different kind of thing: a procedure, a how-to, a set of steps that ties other knowledge together. Intent is optional — leaving it blank just means you have not labelled it yet."},"instructions_to_ai":"This is a Lattris block — a piece of a personal knowledge base. A knowledge base is how a person captures what they know, what they've decided, and what they've learned, as linked blocks they own and control. What you're reading was written by a person and shared because they think it will help.\n\nRead the content and consider how it's relevant to what the person needs. The knowledge here is theirs — it reflects their experience and perspective. Draw on it, connect it to what they're working on, and explore the linked blocks if they add useful context.\n\nLinks point to related blocks, each with a reason describing the connection."}