# Developer reference: crypto derivatives JSON API

Public JSON endpoints that programs call with a free account key, free datasets, an MCP server and x402 pay-per-call history.

Source: https://bykaranteli.com/developers · attribute to ByKaranteli and quote the timestamp.

## Quick examples

Common questions, each answered by one call. The command is the same one listed under its endpoint below; the MCP tool gives the same answer inside an assistant.

### How much was liquidated today, and on which exchange?

Page: https://bykaranteli.com/liquidations · MCP tool: get_liquidations

```sh
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'
```

### Where do BTC liquidations sit around the price, and how much on each side?

Page: https://bykaranteli.com/liqmap · MCP tool: get_liqmap

```sh
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'
```

### Which perps carry the most extreme funding right now, positive or negative?

Page: https://bykaranteli.com/heatmap · MCP tool: get_funding_heatmap

```sh
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'
```

### Where are the BTC options call and put walls?

Page: https://bykaranteli.com/options · MCP tool: get_options_snapshot

```sh
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" "https://bykaranteli.com/api/public/options?venue=all" | jq '.assets.BTC | {venues_included, call_wall, put_wall}'
```

### How much flowed into or out of the US spot bitcoin ETFs on the last trading day?

Page: https://bykaranteli.com/etf · MCP tool: get_etf_flows

```sh
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'
```

### Has an exchange paused withdrawals or deposits for an asset?

Page: https://bykaranteli.com/withdrawals · MCP tool: get_withdrawal_status

```sh
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'
```


## Related

- https://bykaranteli.com/data
- https://bykaranteli.com/guide/connect
- https://bykaranteli.com/pricing

Everything in one fetch: https://bykaranteli.com/llms-full.txt