Skip to content

Assign Tag to Addresses

POST /v2/tags/:tag

How it works

  • If the tag does not exist, it will be created.
  • Each address can have a maximum of 50 tags assigned to it.
  • Addresses are universal. e.g. 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa is a valid address on Bitcoin, Bitcoin Cash, 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 is a valid address on EVM-based chains.

Path Parameters

FieldTypeDescription
tagStringYou can use a-z, 0-9, and underscores. Minimum length is 5 characters. If you don't want to set a tag, you can use 0 as a reserved field.

Body Parameters

Array - The addresses to assign the tag to.

Example

Request

Add
curl "https://api.bmining.pro/v2/tags/satoshi" \
  -X POST \
  -H "Content-Type: application/json" \
 --data-urlencode "api_key=YOUR_API_KEY"
  -d '["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}'

Response

[
  {
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "tags": ["0", "satoshi"],
    "chains": ["bitcoin", "bitcoincash"]
  },
  {
    "address": "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX",
    "tags": ["satoshi"],
    "chains": ["bitcoin", "bitcoincash"]
  }
]