Developer Platform

API reference and integration guide

Build against a bearer-authenticated market data API with billing, usage tracking, and WebSocket streaming.

Bearer auth

Authenticate requests with an API key in the Authorization header.

Realtime

Use WebSocket streaming for live prices and signal updates.

Billing

Track usage, manage subscriptions, and surface paid access cleanly.

API Keys

No account?

Quick Start

Get up and running in three steps.

1

Create an account

curl -X POST https://api.dynamind.network/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"secret"}'
2

Fetch market data

curl https://api.dynamind.network/api/v1/price/BTC/USDT \
  -H "Authorization: Bearer dm_your_key"
3

Stream real-time

wscat -c "ws://api.dynamind.network?apiKey=dm_your_key"

Authentication

Authentication is email/password-based. Register or sign in to receive a JWT token and your first API key. All subsequent requests use the API key as a bearer token. You can create additional keys from the dashboard above.

Register

POST https://api.dynamind.network/api/v1/auth/register
Content-Type: application/json

{
  "email": "you@example.com",
  "password": "your-password"
}

Sign In

POST https://api.dynamind.network/api/v1/auth/login
Content-Type: application/json

{
  "email": "you@example.com",
  "password": "your-password"
}

Response

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "apiKey": "dm_xxxxxxxxxxxxxxxxxxxx",
  "user": {
    "id": "...",
    "email": "you@example.com"
  }
}
Authorization: Bearer dm_xxxxxxxxxxxxx

GET /api/v1/keys
POST /api/v1/keys
DELETE /api/v1/keys/:id

SDK & Installation

Install the official SDK for your language or use cURL directly.

Node.js

npm install @dynamind/sdk

Python

pip install dynamind

cURL

curl https://api.dynamind.network/api/v1/price/BTC/USDT \
  -H "Authorization: Bearer dm_your_key"

Market Data

Market routes return aggregated prices, historical candles, order book snapshots, trade snapshots, and health data.

MethodEndpointDescription
GET/api/v1/price/:symbolAggregated price
GET/api/v1/ohlcv/:symbolHistorical candles
GET/api/v1/orderbook/:symbolOrder book snapshot
GET/api/v1/trades/:symbolRecent trade snapshot
GET/api/v1/market/statsAggregator statistics
GET/api/v1/healthService health

Response Example

{
  "symbol": "BTC/USDT",
  "price": 67432.18,
  "change24h": 2.34,
  "volume24h": 28439102847,
  "timestamp": "2026-06-30T14:30:00Z",
  "source": "aggregated",
  "exchanges": 5
}

Account & Billing

Account routes cover API keys, usage, subscription status, and billing entry points.

MethodEndpointDescription
GET/api/v1/keysList API keys
POST/api/v1/keysCreate API key
DELETE/api/v1/keys/:idRevoke API key
GET/api/v1/usageUsage summary
GET/api/v1/subscriptionSubscription status
GET/api/v1/billing/pricesAvailable plans
POST/api/v1/billing/checkoutStart checkout
POST/api/v1/billing/portalOpen billing portal

Usage Example

{
  "period": "2026-06",
  "requests": 14520,
  "limit": 50000,
  "overage": 0,
  "plan": "pro"
}

Top Up

Every API request costs credits. Add credits to your account to keep making requests.

How It Works

  • Navigate to /api/topup to add credits
  • Pay with USDC on Ethereum or Solana
  • Credits are stored in your account and deducted per request
  • Check your balance via GET /api/v1/usage

Bonus Tiers

Larger top-ups earn bonus credits.

$50+10% bonus
$100+20% bonus
$500+30% bonus

Connect your wallet to top up your account with crypto

See the pricing page for per-request credit costs.

Realtime

Connect to the WebSocket gateway for live ticker and signal updates.

ws://api.dynamind.network?apiKey=dm_xxxxxxxxxxxxx

{
  "type": "subscribe",
  "channels": ["ticker:BTC/USDT", "signal:ETH/USDT"]
}

Subscription Response

{
  "type": "ticker",
  "symbol": "BTC/USDT",
  "price": 67432.18,
  "bid": 67431.50,
  "ask": 67432.86,
  "volume": 1234.56,
  "timestamp": 1751234567890
}

Rate Limits

Rate limits are applied per API key and vary by plan.

PlanPriceRequests/minRequests/dayWebSocket
Free$0/mo101,0001
Starter$19/mo10010,0005
Pro$79/mo600100,00020
Enterprise$299/mo6,000Unlimited50

Every response includes rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Error Codes

The API uses standard HTTP status codes to indicate success or failure.

CodeMeaningDescription
400Bad RequestInvalid parameters or malformed request body
401UnauthorizedMissing or invalid API key
403ForbiddenAPI key lacks required permissions
429Too Many RequestsRate limit exceeded, retry after cooldown
500Server ErrorInternal error, contact support if persistent