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
  }
}
'

import requests

url = "https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances"

payload = {
    "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
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
    }
  })
};

fetch('https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances"

	payload := strings.NewReader("{\n  \"idempotencyKey\": \"ba943ff1-ca16-49b2-ba55-1057e70ca5c7\",\n  \"currency\": \"USDC\",\n  \"localBalance\": 1000000,\n  \"asOfDate\": \"2025-06-26\",\n  \"reportType\": \"eea\",\n  \"additionalFields\": {\n    \"equivalentEuroLocalBalance\": 26994.6,\n    \"totalBalance\": 5000000,\n    \"equivalentEuroTotalBalance\": 853949.09\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idempotencyKey\": \"ba943ff1-ca16-49b2-ba55-1057e70ca5c7\",\n  \"currency\": \"USDC\",\n  \"localBalance\": 1000000,\n  \"asOfDate\": \"2025-06-26\",\n  \"reportType\": \"eea\",\n  \"additionalFields\": {\n    \"equivalentEuroLocalBalance\": 26994.6,\n    \"totalBalance\": 5000000,\n    \"equivalentEuroTotalBalance\": 853949.09\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"idempotencyKey\": \"ba943ff1-ca16-49b2-ba55-1057e70ca5c7\",\n  \"currency\": \"USDC\",\n  \"localBalance\": 1000000,\n  \"asOfDate\": \"2025-06-26\",\n  \"reportType\": \"eea\",\n  \"additionalFields\": {\n    \"equivalentEuroLocalBalance\": 26994.6,\n    \"totalBalance\": 5000000,\n    \"equivalentEuroTotalBalance\": 853949.09\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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
    }
  }
}

{
  "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
    }
  }
}

{
  "code": 400,
  "message": "Bad request."
}

{
  "code": 401,
  "message": "Malformed authorization."
}

{
  "code": 3,
  "message": "Forbidden"
}

{
  "code": 409,
  "message": "Conflicts with another request."
}

Create daily custody balance report

Creates a daily custody balance report for USDC and EURC and sends it to Circle.

For reportType=eea, this endpoint represents the four reportable cells of EBA Template S 08.00 for one token and one reference date: CASP total token count and EUR value, plus the EU-client subset token count and EUR value.

MiCA / EBA S 08.00 mapping (reportType=eea):

S 08.00 Row 0010 / Col 0010 maps to additionalFields.totalBalance
S 08.00 Row 0010 / Col 0020 maps to additionalFields.equivalentEuroTotalBalance
S 08.00 Row 0020 / Col 0010 maps to localBalance
S 08.00 Row 0020 / Col 0020 maps to additionalFields.equivalentEuroLocalBalance

localBalance and totalBalance are token-unit counts. equivalentEuroLocalBalance and equivalentEuroTotalBalance are EUR values. EU clients are determined by habitual residence for natural persons and registered office for legal persons. USD/EUR FX conversion should be based on the ECB rate applicable for that date, as available on the ECB website.

Validation rules:

localBalance must be less than or equal to additionalFields.totalBalance
equivalentEuroLocalBalance must be less than or equal to equivalentEuroTotalBalance
Only one submission per day per currency
USDC and EURC require separate submissions

POST

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
  }
}
'

import requests

url = "https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances"

payload = {
    "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
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
    }
  })
};

fetch('https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances"

	payload := strings.NewReader("{\n  \"idempotencyKey\": \"ba943ff1-ca16-49b2-ba55-1057e70ca5c7\",\n  \"currency\": \"USDC\",\n  \"localBalance\": 1000000,\n  \"asOfDate\": \"2025-06-26\",\n  \"reportType\": \"eea\",\n  \"additionalFields\": {\n    \"equivalentEuroLocalBalance\": 26994.6,\n    \"totalBalance\": 5000000,\n    \"equivalentEuroTotalBalance\": 853949.09\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idempotencyKey\": \"ba943ff1-ca16-49b2-ba55-1057e70ca5c7\",\n  \"currency\": \"USDC\",\n  \"localBalance\": 1000000,\n  \"asOfDate\": \"2025-06-26\",\n  \"reportType\": \"eea\",\n  \"additionalFields\": {\n    \"equivalentEuroLocalBalance\": 26994.6,\n    \"totalBalance\": 5000000,\n    \"equivalentEuroTotalBalance\": 853949.09\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.circle.com/v2/reserveManagement/dailyCustodyBalances")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"idempotencyKey\": \"ba943ff1-ca16-49b2-ba55-1057e70ca5c7\",\n  \"currency\": \"USDC\",\n  \"localBalance\": 1000000,\n  \"asOfDate\": \"2025-06-26\",\n  \"reportType\": \"eea\",\n  \"additionalFields\": {\n    \"equivalentEuroLocalBalance\": 26994.6,\n    \"totalBalance\": 5000000,\n    \"equivalentEuroTotalBalance\": 853949.09\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "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
    }
  }
}

{
  "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
    }
  }
}

{
  "code": 400,
  "message": "Bad request."
}

{
  "code": 401,
  "message": "Malformed authorization."
}

{
  "code": 3,
  "message": "Forbidden"
}

{
  "code": 409,
  "message": "Conflicts with another request."
}

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.

Show child attributes

Response

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

data

object

Show child attributes

Create a mock PIX payment

Get credit line details

⌘I