Skip to main content
POST
/
v2
/
reserveManagement
/
dailyCustodyBalances
Create daily custody balance report
curl --request POST \
  --url https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotencyKey": "ba943ff1-ca16-49b2-ba55-1057e70ca5c7",
  "currency": "USDC",
  "localBalance": 1000000,
  "asOfDate": "2025-06-26",
  "reportType": "eea",
  "additionalFields": {
    "equivalentEuroLocalBalance": 26994.6,
    "totalBalance": 5000000,
    "equivalentEuroTotalBalance": 853949.09
  }
}
'
{
  "data": {
    "idempotencyKey": "ba943ff1-ca16-49b2-ba55-1057e70ca5c7",
    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
    "createDate": "2025-07-15T18:03:52.429Z",
    "localBalance": 1000000,
    "currency": "USDC",
    "asOfDate": "2025-06-26",
    "reportType": "eea",
    "additionalFields": {
      "equivalentEuroLocalBalance": 26994.6,
      "totalBalance": 5000000,
      "equivalentEuroTotalBalance": 853949.09
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
idempotencyKey
string<uuid>
required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

Example:

"ba943ff1-ca16-49b2-ba55-1057e70ca5c7"

​
currency
enum<string>
required

The type of token being reported.

Available options:
USDC,
EURC
Example:

"USDC"

​
localBalance
number<double>
required

Regional specific balance for the provided token type, expressed in token units.

For eea, this is the EU-client subset (not the CASP's total holdings). EU clients are determined by habitual residence for natural persons and registered office for legal persons.

For japan_trust, this is the total amount held in custody on behalf of customers of the EPIESP.

Example:

1000000

​
asOfDate
string<date>
required

The day being reported in the format YYYY-MM-DD with timezone UTC.

Example:

"2025-06-26"

​
reportType
enum<string>
required

The type of report being created.

Available options:
eea,
japan_trust
Example:

"eea"

​
additionalFields
object
required

Additional fields are required only for the eea report type. They are ignored for the japan_trust report type.

Response

Request with duplicate values and idempotency key has already been made. Existing record is returned.

​
data
object