Creating account address

Creating account address

POST /api/public/v1/accounts/:id/addresses

This endpoint creates a new address for a given account ID.

Please note that this request is asynchronous and you will want to make a separate Listing Account Addresses rerequest.

Headers

Name	Value
Content-Type	application/vnd.api+json
Authorization	Bearer <api_key>

Path Parameters

Name	Type	Description
id	string	Account ID.

Body

Name	Type	Description
data	object	Object with exchange request data.
data.type	string	Exchange request type. Always addresses.
data.attributes	object	A set of exchange request attributes.
data.attributes.network_id	string	Network ID. Refer to Reading account
data.attributes.label	string	Address label. It can be anything that helps the user to recognize the address.

Request JSON

{
  "data": {
    "type": "addresses",
    "attributes": {
      "network_id": "string",
      "label": "string"
    }
  }
}

Response

HTTP 200

{
  "data": {
    "id": "0a37e656-fdca-4afb-b78e-992a38279c9d",
    "type": "addresses",
    "attributes": {
      "label": "New Label",
      "value": null,
      "createdAt": "2025-05-29T18:15:35.492Z"
    },
    "relationships": {
      "account": {
        "meta": {
          "included": false
        }
      },
      "network": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "Invalid attribute",
      "code": "address_invalid",
      "detail": "Network does not match account currency",
      "source": {
        "pointer": "/data/attributes/networkId"
      }
    }
  ]
}

HTTP 404

{
  "errors": [
    {
      "status": 404,
      "title": "Record not found",
      "code": "network_not_found",
      "detail": "Network not found"
    }
  ]
}