WhiteBIT API Documentation

Official documentation for WhiteBIT's REST and WebSocket APIs, built with Mintlify.

Prerequisites

Before you begin, make sure the following tools are installed on your machine:

Tool	Minimum Version	Installation
Node.js	v18+	Download or use nvm
npm	v9+ (ships with Node.js)	Included with Node.js
Mintlify CLI	latest	npm install -g mintlify@latest
Redocly CLI	latest	npm install -g @redocly/cli@latest
AsyncAPI CLI	latest	npm install -g @asyncapi/cli

Verify your setup:

node --version    # Should print v18.x or higher
npm --version     # Should print 9.x or higher
mint --version    # Mintlify CLI
redocly --version # Redocly CLI
asyncapi --version # AsyncAPI CLI

Quick Start

Get the documentation running locally in 2 minutes:

# Install Mintlify CLI (if not already installed)
npm install -g mintlify@latest

# Start dev server
mint dev

# Open http://localhost:3000

Contributing

See CONTRIBUTING.md for:

• Git workflow and branching strategy
• Commit message format
• Pull request process
• Review checklists for tech writers, DevRel engineers, and developers

External Resources

• OpenAPI 3.0.3 Specification
• AsyncAPI 3.0.0 Specification
• Mintlify Documentation

Project Structure

mintlify-docs/
├── openapi/           # OpenAPI specifications (REST APIs)
│   ├── public/        # Public endpoints (no auth)
│   └── private/       # Private endpoints (require auth)
├── asyncapi/          # AsyncAPI specifications (WebSocket)
│   ├── public/        # Public channels
│   └── private/       # Private channels
├── public/            # MDX docs for public APIs
├── private/           # MDX docs for private APIs
└── docs.json          # Navigation configuration

Getting Help

For technical questions:

• Check existing similar endpoints in the codebase
• Search OpenAPI/AsyncAPI specifications

For style questions:

• Ask tech writer team lead
• Check glossary for terminology

For API accuracy questions:

• Ask backend engineering team
• Check staging environment responses
• Review internal API specifications

For process questions:

• Review CONTRIBUTING.md
• Ask DevRel team lead
• Check PR review checklists

Validation Before Submitting

Always validate your changes before creating a PR:

# OpenAPI validation
npx @redocly/cli lint openapi/**/*.yaml

# AsyncAPI validation
find asyncapi -name "*.yaml" -exec asyncapi validate {} \;

# Test in dev server
mint dev

---