# Celsius Network

> Celsius Network was a global cryptocurrency lending and custody platform that let retail and
> institutional customers earn yield on crypto deposits, borrow against them, and — through the
> Celsius Partner API — let third-party partners embed that earning power in their own
> applications. The company froze withdrawals in June 2022, filed for Chapter 11 in July 2022,
> emerged on 2024-01-31 and shut down its apps on 2024-02-29. **The Celsius Partner API is
> retired and its hosts no longer resolve.** This document preserves the contract as a
> historical record.

Generated by the API Evangelist enrichment pipeline on 2026-08-02. Method: generated from
apis.yml plus the artifacts in this repository, all of which derive from two first-party
sources fetched the same day — the public Celsius Postman collection and the official
`celsius-sdk` npm package. Celsius Network publishes no llms.txt of its own; probes of
`https://celsius.network/llms.txt` returned HTTP 404.

## Status

- Chapter 11 filed: 2022-07-13 (Southern District of New York)
- Plan of reorganization confirmed: 2023-11-09
- Emerged from Chapter 11: 2024-01-31
- Mobile and web apps shut down: 2024-02-29
- Production API host `wallet-api.celsius.network`: NXDOMAIN as of 2026-08-02
- Developer portal `developers.celsius.network`: NXDOMAIN as of 2026-08-02
- Successor mining entity: Ionic Digital (Nasdaq: IOND) — a separate company with no Celsius API surface

## APIs

- [Celsius Partner API](https://www.postman.com/labs-celsiusnet-decents/celsius-public/documentation/tsw6j4r/celsius-api): Partner-facing wallet, interest, KYC and utility API. 21 paths, 24 operations across four tags — Wallet, KYC, Users, Utility. Retired.

## Specs

- [OpenAPI 3.1.0 (derived)](openapi/celsius-network-partner-api-openapi.yml): the Partner API contract, derived from the Postman collection and the official SDK source. No path, verb, parameter or example is invented.
- [OpenAPI Overlay](overlays/celsius-network-partner-api-overlay.yaml): API Evangelist enhancements — provenance, retirement state, PII and consequence flags.
- [Postman collection (verbatim)](postman/celsius-network-partner-api.postman_collection.json): the first-party collection Celsius published, saved as fetched.

## Contract

- Base URL (production, retired): `https://wallet-api.celsius.network`
- Base URL (staging, retired): `https://wallet-api.staging.celsius.network`
- Auth: three API-key headers. `X-Cel-Partner-Token` always; plus `X-Cel-User-Token` for Segmented Integration partners or `X-Cel-Api-Key` for Omnibus and Omnibus Treasury partners.
- Response integrity: every response carried an `X-Signature` header, verified by the SDK against a per-environment RSA public key.
- Pagination: `page` and `per_page` query parameters; a `pagination` wrapper with `total`, `pages`, `current`, `per_page`, `showing`.
- Errors: `{message, slug}` JSON envelope. Not RFC 9457. Branch on `slug`.
- Idempotency: none. `withdraw` is irreversible and has no idempotency key.
- Rate limits: none published.

## Operations

- Wallet: `getBalanceSummary`, `getCoinBalance`, `getInterestSummary`, `getTransactionSummary`, `getCoinTransactions`, `getTransactionStatus`, `getDeposit`, `withdraw`, `getWithdrawalAddresses`, `getWithdrawalAddressForCoin`
- KYC: `getKycStatus`, `verifyKyc`, `getKycVerificationStatus`, `startKycVerification`
- Users: `createUser`, `updateUser`, `updateUserEmail`
- Utility: `getInterestRates`, `getSupportedCurrencies`, `getSupportedCountries`, `getStatistics`, `confirmTermsOfUse`, `getHealth`, `health`

## Artifacts

- [Authentication profile](authentication/celsius-network-authentication.yml): the three API-key header schemes.
- [Conventions](conventions/celsius-network-conventions.yml): auth style, response signing, pagination, error envelope, content types, absence of idempotency and rate limits.
- [Error catalog](errors/celsius-network-problem-types.yml): 12 documented error conditions with slugs, statuses and remediation, harvested from published example responses.
- [Data model](data-model/celsius-network-data-model.yml): 15 entities and their relationships — Partner, User, KycApplication, Coin, CoinBalance, AccruedInterest, Transaction, DepositAddress, WithdrawalAddress, WithdrawalScheme and more.
- [Lifecycle](lifecycle/celsius-network-lifecycle.yml): the full retirement timeline, retired hosts and surviving surfaces.
- [Sandbox](sandbox/celsius-network-sandbox.yml): the staging/production two-environment model. No magic test values were ever published.
- [Packages](packages/celsius-network-packages.yml): the one first-party client library, `celsius-sdk` on npm.
- [Changelog](changelog/celsius-network-changelog.yml): 17 dated releases from 2018-12-17 to 2022-03-10, structured from the SDK CHANGELOG.
- [Conformance](conformance/celsius-network-conformance.yml): what the contract does and does not conform to.
- [Domain security](security/celsius-network-domain-security.yml): probed TLS, DNSSEC, CAA, SPF and DMARC.
- [Well-known](well-known/celsius-network-well-known.yml): every `/.well-known/` probe and its status. No documents found.
- [Agentic access](agentic-access/celsius-network-agentic-access.yml): recommended execution contracts per operation.

## Agent Skills

- [Onboard and KYC-verify a partner user](skills/celsius-network-onboard-and-verify-user.md)
- [Fund a wallet and track accrued interest](skills/celsius-network-deposit-and-earn.md)
- [Withdraw and reconcile the transaction](skills/celsius-network-withdraw-and-reconcile.md)

## SDKs

- [celsius-sdk (npm)](https://www.npmjs.com/package/celsius-sdk): the official JavaScript SDK for Node.js backends. Apache-2.0. Last published 2022-04-12 at version 1.0.0. Unmaintained; its source repository has been removed.

## Docs

- [Celsius API on Postman](https://www.postman.com/labs-celsiusnet-decents/celsius-public/documentation/tsw6j4r/celsius-api): the surviving first-party API documentation, including the data-structure reference and example responses.
- [Postman documenter view](https://documenter.getpostman.com/view/4207695/Rzn6v2mZ)

## Company

- [Wind-down notice](https://celsius.network/): the current celsius.network homepage.
- [Creditor claims portal](https://claimsportal.celsius.network)
- [Bankruptcy case administration (Stretto)](https://cases.stretto.com/celsius/)
- [Distribution support](https://celsiusdistribution.stretto.com/support/solutions)
- [Privacy policy](https://celsius.network/static/privacy-policy.pdf)
- [GitHub organization](https://github.com/CelsiusNetwork): still present, zero public repositories as of 2026-08-02.

## Not present

Probed 2026-08-02 and confirmed absent on every Celsius host: `/llms.txt`, `/.well-known/security.txt`,
`/.well-known/openid-configuration`, `/.well-known/oauth-authorization-server`, `/.well-known/api-catalog`,
`/.well-known/ai-plugin.json`, `/.well-known/agent-card.json`, `/.well-known/agent.json`. There is no MCP
server, no A2A agent card, no AsyncAPI, no webhook surface, no GraphQL endpoint, no gRPC/protobuf, no CLI,
no embedded UI components, no OAuth scopes, no status page, no vulnerability-disclosure program and no
trust center.