---
title: "On-chain stats and recent DEX swaps matched to a trading pair (free, no auth)"
method: GET
path: "/api/public/onchain-pair-stats"
tags: ["free"]
---

# On-chain stats and recent DEX swaps matched to a trading pair (free, no auth)

`GET /api/public/onchain-pair-stats`

## Request

- Base URL: `https://coinlobster.com`
- URL: `https://coinlobster.com/api/public/onchain-pair-stats`
- Auth: none required

On-chain stats and recent DEX swaps matched to a trading pair's base token (e.g. BTC/USD matches WBTC/cbBTC pools). Free tier: stats + swaps >= $250K, no net flow. Pro webapp sessions get the full swap list (capped 50) plus 1h/24h buy/sell net flow.

## Query parameters

- `pair` string, required

## Response `200`

Matched token stats and recent swaps

- object
  - `success` true, required
  - `data` object, required: Endpoint-specific payload. Every field it carries is documented in llms-full.txt and returned by /discover.
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

## Other responses

- `400`: pair param required

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)
