Import receiving addresses

Import merchant-controlled receiving addresses into StableOps, with chain-aware normalization, environment checks, and duplicate handling for address pools.

POST/v1/addresses/import

Authorization

bearerAuth

AuthorizationBearer <token>

Paste your API key from the dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

addresses*array<>

List of addresses to import (max 1,000 entries). Each entry specifies chain, address, and optional label.

mode?string

Address allocation mode. "single" (default): address is exclusive to one active order. "shared": multiple orders can share the same address.

Response Body

`application/json`

curl -X POST "https://example.com/v1/addresses/import" \  -H "Content-Type: application/json" \  -d '{    "addresses": [      {        "chain": "ethereum",        "address": "string"      }    ]  }'

{
  "imported": 0,
  "addresses": [
    {
      "id": "string",
      "chain": "ethereum",
      "address": "string",
      "label": "string",
      "mode": "single",
      "status": "available",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

Import receiving addresses

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`