API Reference›Getting Started›Quick Start

Quick Start

Create an API key and make your first request.

You can call public market-data endpoints with no setup at all. To read your account or trade, you first create an API key.

1. Create an API key

Sign in to SPACEDEX, open Account, then API. Create a new key and choose its permissions. You will see the API key once and the secret key only once, so store the secret somewhere safe. If you lose it, delete the key and create a new one.

Permission	What it allows
Read	Read account balances, orders and trades (USER_DATA)
Trade	Place and cancel orders (TRADE)
Withdraw	Submit withdrawals (disabled by default; enable with care)

CautionTreat your secret key like a password. Anyone with it can act on your account within the key's permissions. Never commit it to source control or paste it into a browser.

2. Make your first public request

Check connectivity and read the current price of a symbol. No key required.

bash

curl "https://api.spacedex.com/api/v1/ping"
# {}

curl "https://api.spacedex.com/api/v1/ticker/price?symbol=BTCUSDT"
# {"symbol":"BTCUSDT","price":"64210.50"}

3. Make your first signed request

Read your balances. This requires your API key and a signature (full details in Authentication).

bash

API_KEY="your-api-key"
SECRET="your-secret-key"
QUERY="timestamp=$(($(date +%s)*1000))"
SIG=$(echo -n "$QUERY" | openssl dgst -sha256 -hmac "$SECRET" | cut -d' ' -f2)

curl -H "X-SDX-APIKEY: $API_KEY" \
  "https://api.spacedex.com/api/v1/account?$QUERY&signature=$SIG"

NoteThat is the whole loop: pick an endpoint, add auth if it is signed, send the request. The rest of these pages document each endpoint in detail.

PreviousIntroduction NextAuthentication