Skip to content

Create a Live API key

The key that moves real money, once your workspace is activated for Live.

Sandbox: test money only. No request moves real money.

In this step you create the key that moves real money. It exists only for a workspace activated for Live; see Complete Live activation.

Create it

Live keys start with nbk_live_ and work only on the Live host. You create one in your dashboard, under Developers, API keys, once your workspace is active on Live. In Live only an Owner or an Admin creates a key, after a sign-in within the last 5 minutes. Like a sandbox key, it is shown once.

Choose its scopes: there is no default, and a key never holds one your role lacks. Your first Live order lists the six a first order uses.

Keep it apart from your test key

Keep the key on your server, in your secret manager or the NASFAM_LIVE_KEY environment variable, and the sandbox key in NASFAM_SANDBOX_KEY, so a test run can never reach the live balance. Never put either in browser JavaScript or an app. A key never works on the other environment's host.

The same code runs against both environments: change the base URL and the key, nothing else. Create and manage API keys covers rotation and revocation.

What you should see

GET /account with the new key answers with an environment of live and a kyb_status of active:

Code for What you should see
The account behind a Live key
JSON
200 OKSynthetic sandbox data
{  "id": "org_01K7SAMP000000000000000090",  "name": "Example Business Ltd",  "environment": "live",  "kyb_status": "active",  "limits": {    "max_queued": 50  }}

If it fails

What you seeWhat to check
You cannot create a live keyYour workspace is not active on Live, or your role is not Owner or Admin. Your dashboard says what is left; see Complete Live activation.
key_environment_mismatchThe key and the host belong to different environments. Each key works on its own host only.
The dashboard asks you to sign in againYour sign-in is older than 5 minutes. Sign in again, then create the key.
You did not copy the key when it was shownIt cannot be shown again. Revoke it in the dashboard and create another.

Next step

Live step 4 of 5: Send real orders. The same code, the Live host and your Live key. A first read proves them, then the checklist, then your first real order.