---
title: "Get balance"
method: GET
path: "/v0.1/balances/{currencyId}/{owner}"
tags: ["User balances"]
---

# Get balance

`GET /v0.1/balances/{currencyId}/{owner}`

## Request

- Base URL: `https://api.rarible.org`
- URL: `https://api.rarible.org/v0.1/balances/{currencyId}/{owner}`
- Auth: API key in header `X-API-KEY`

Return user's balance of specified currency

## Path parameters

- `currencyId` string, required: Currency Id, has format `ETHEREUM:${token}` or `ETHEREUM:${token}:${tokenId}`
- `owner` string, required: Blockchain address in Union format `${blockchainGroup}:${token}`

## Response `200`

OK

- Balance
  - `currencyId` string, required: Currency Id, has format `ETHEREUM:${token}` or `ETHEREUM:${token}:${tokenId}`
  - `owner` string, required: Blockchain address in Union format `${blockchainGroup}:${token}`
  - `balance` string, required
  - `decimal` string, required

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api.md) - [All operations](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api/revisions/5d2651b9411d?raw)