Addresses

Addresses enable you to manage and interact with crypto wallets programmatically. On this page, you’ll find everything you need to create, retrieve, and manage addresses through our API.

The address model

The address model represents a blockchain wallet address registered through the Coba API. It includes details such as the wallet address and the associated cryptocurrency.

Each address is uniquely identified by an ID, which is used to reference the address in client-side or follow-up operations.

To create a new address, the user must have a status of approved.

POST/crypto/addresses

Create an address

This endpoint allows you to register a new wallet address. To successfully create an address, the user must be approved.

Required attributes

Name
user_id
Type
string
Description
The unique identifier of the user who owns the wallet.
Name
address
Type
string
Description
The blockchain address of the wallet.
Name
crypto
Type
string
Description
The cryptocurrency associated with the address.
One of: USDC, USDC_POLYGON_NXTB, SOL_USDC_PTHX, XLM_USDC_5F3T, USDT_POLYGON, USDT_ERC20, TRX_USDT_S2UZ

Optional attributes

Name
label
Type
string
Description
A human-readable label to help identify the address.

Request

POST

/crypto/addresses

curl -X POST https://sandbox.api.coba.ai/metal/crypto/addresses \
  -H "Authorization: Bearer {token}" \
  -H "X-Coba-Metal-API-Key: {client_api_key}" \
  -d '{
    "address": {
        "user_id": "68811830bb6e5d659501e1e8",
        "address": "0xaBCb3E5H28B8678c017EFb11FB63ce98HEa83263",
        "crypto": "USDC_POLYGON_NXTB",
        "label": "John's wallet"
    }
}'

Successful Response

  {
    "id": "697cd4424af1f1f07de8e7a4",
    "advanced_verification_status": null,
    "address": "0xaBCb3E5H28B8678c017EFb11FB63ce98HEa83263",
    "crypto": "USDC_POLYGON_NXTB",
    "created_at": "2025-06-23T20:14:53.850Z",
    "user_id": "68811830bb6e5d659501e1e8",
    "approved": true,
    "last_checked": "2025-06-23T20:14:53.850Z",
    "label": "John's wallet",
  }

GET/crypto/addresses/{id}

Get an address

This endpoint allows you to retrieve the details of a specific wallet address.

Request

GET

/crypto/addresses/{id}

curl -X GET https://sandbox.api.coba.ai/metal/crypto/addresses/{id} \
  -H "Authorization: Bearer {token}" \
  -H "X-Coba-Metal-API-Key: {client_api_key}"
}'

Successful Response

  {
    "id": "697cd4424af1f1f07de8e7a4",
    "advanced_verification_status": null,
    "address": "0xaBCb3E5H28B8678c017EFb11FB63ce98HEa83263",
    "crypto": "USDC_POLYGON_NXTB",
    "created_at": "2025-06-23T20:14:53.850Z",
    "user_id": "68811830bb6e5d659501e1e8",
    "approved": true,
    "last_checked": "2025-06-23T20:14:53.850Z",
    "label": "John's wallet",
  }