# DpExchangeGemini

> ## ⚠️ EXPERIMENTAL — read this before depending on it
>
> This package has **never run in production.** It is published early and openly so it
> can be used and reported on, not because it is finished.
>
> - **The API may change without a major version.** Pin three-part (`~> 0.1.0`).
> - **Verification is uneven, and the gaps are on the expensive side.** The conformance
>   suite passes against a fake, and against Gemini's live public endpoints.
>   **Order placement and authenticated flows are thinly covered.** No test in this repo
>   spends money.
> - **Maturity is declared per endpoint.** Read `capabilities/0`, not this banner.
>
> [Report a divergence](https://github.com/DistortionPoint/dp-exchange-gemini/issues).

Gemini for the **DpExchange** family: market data, trading and streaming behind the
same facade every venue in the family exposes.

## What this package covers

88 callbacks, of which **63 are declared `:experimental`** and 25 `:unsupported`. None is `:proven` — that requires a consumer trading live, and this package has never run in production (D15).

Asset classes: **crypto**. Streamed kinds: **quotes, top of book** — everything else pulls only.

Of the 25 unsupported endpoints, **22 are the venue's own absence**, not this package's backlog — see `venue_does_not_serve/0` and `docs/reference/gemini/negative-claims.md`, which records the source and date behind every one.

## Installation

```elixir
def deps do
  [
    {:dp_exchange_gemini, "~> 0.1.0"}
  ]
end
```

## Usage

```elixir
# In your supervision tree. Nothing starts itself.
children = [{DpExchange.Gemini, credentials: my_credentials()}]

{:ok, quote} = DpExchange.Gemini.get_price("BTCUSD", [])

:ok = DpExchange.Gemini.subscribe(["BTCUSD"], to: self())
```

`DpExchange.Gemini` is the **entire public API**. Everything else — transport, signing,
session handling, supervision — is internal, and the conformance suite asserts it.

See [`dp_exchange_core`](https://hex.pm/packages/dp_exchange_core) for the contract, and
this package's `usage-rules.md` for what is specific to Gemini.

## License

MIT. See [LICENSE](https://github.com/DistortionPoint/dp-exchange-gemini/blob/main/LICENSE).