REST reference / Listen Keys

Create a Listen Key

POST/fapi/v1/listenKey
API keyWeight 1

Overview

Create or rearm the calling credential's 60-minute Listen Key

Send X-MBX-APIKEY. No signature or timestamp is needed. Authentication guide

Behavior and request rules

API key only. No HMAC signature, timestamp or listenKey parameter is required. Operates on the calling credential's key, not a supplied bearer. Sibling credentials retain independent Listen Keys. PUT without a live key returns -1125; DELETE is idempotent.

Parameters

This endpoint takes no parameters.

Responses

Success

listenKeystringrequired

Synthetic examples only. Treat a real Listen Key as a bearer secret.

type
"string"
pattern
"^[0-9a-f]{64}$"
type
"object"
additionalProperties
false
Response headers
X-DP-ACCOUNT-USED-WEIGHT-1M

Per-verified-Trading-Account admitted weight when authenticated.

X-MBX-USED-WEIGHT-1M

Per-IP admitted request weight in the current minute. Requests admitted by the limiter count even if authentication or validation later fails.

Raw response schema
Response schema
{
  "$ref": "#/components/schemas/ListenKey"
}
Errors, limits and retry behavior