From 64068f89bd9400b4e684b8eb1fdf5bdede893a36 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 3 Aug 2026 21:54:19 +0000
Subject: [PATCH 1/5] feat(api): Add limit_cash_amount and limit_cash_count to
 VelocityLimit template

---
 .stats.yml                                      |  4 ++--
 .../types/auth_rules/velocity_limit_params.py   | 17 +++++++++++++++++
 .../auth_rules/velocity_limit_params_param.py   | 17 +++++++++++++++++
 3 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 39c488a2..8fe8167c 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 213
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-59c09c7355b21b663e001d2ee1086ebd0a70d9b5433823282bca296eedff9eb0.yml
-openapi_spec_hash: d9c3b932c810809abc6e973d662ad376
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-1d6c7b672aa49dfe0fe5175965307f63a0ed42c13697b2f9f3b9275f32331937.yml
+openapi_spec_hash: 06e73960c7506484c589d718fa1ddad8
 config_hash: 337a99d8cc30006358b7bc2531401669
diff --git a/src/lithic/types/auth_rules/velocity_limit_params.py b/src/lithic/types/auth_rules/velocity_limit_params.py
index 061a8de7..6914b7d9 100644
--- a/src/lithic/types/auth_rules/velocity_limit_params.py
+++ b/src/lithic/types/auth_rules/velocity_limit_params.py
@@ -26,6 +26,23 @@ class VelocityLimitParams(BaseModel):
     limit will be declined.
     """
 
+    limit_cash_amount: Optional[int] = None
+    """
+    The maximum amount of cash spend velocity allowed in the period in minor units
+    (the smallest unit of a currency, e.g. cents for USD). Cash spend covers ATM
+    withdrawals, cash disbursements, and purchases with cashback. Transactions
+    exceeding this limit will be declined.
+    """
+
+    limit_cash_count: Optional[int] = None
+    """
+    The number of cash spend velocity impacting transactions may not exceed this
+    limit in the period. Transactions exceeding this limit will be declined. A cash
+    velocity impacting transaction is an ATM withdrawal, cash disbursement, or
+    purchase with cashback that has been authorized, and optionally settled, or a
+    force post (a transaction that settled without prior authorization).
+    """
+
     limit_count: Optional[int] = None
     """
     The number of spend velocity impacting transactions may not exceed this limit in
diff --git a/src/lithic/types/auth_rules/velocity_limit_params_param.py b/src/lithic/types/auth_rules/velocity_limit_params_param.py
index e91557fa..8fe6b058 100644
--- a/src/lithic/types/auth_rules/velocity_limit_params_param.py
+++ b/src/lithic/types/auth_rules/velocity_limit_params_param.py
@@ -27,6 +27,23 @@ class VelocityLimitParamsParam(TypedDict, total=False):
     limit will be declined.
     """
 
+    limit_cash_amount: Optional[int]
+    """
+    The maximum amount of cash spend velocity allowed in the period in minor units
+    (the smallest unit of a currency, e.g. cents for USD). Cash spend covers ATM
+    withdrawals, cash disbursements, and purchases with cashback. Transactions
+    exceeding this limit will be declined.
+    """
+
+    limit_cash_count: Optional[int]
+    """
+    The number of cash spend velocity impacting transactions may not exceed this
+    limit in the period. Transactions exceeding this limit will be declined. A cash
+    velocity impacting transaction is an ATM withdrawal, cash disbursement, or
+    purchase with cashback that has been authorized, and optionally settled, or a
+    force post (a transaction that settled without prior authorization).
+    """
+
     limit_count: Optional[int]
     """
     The number of spend velocity impacting transactions may not exceed this limit in

From 168e194dce255e6b907a65b3387dffec89ca0426 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 4 Aug 2026 14:24:34 +0000
Subject: [PATCH 2/5] feat(api): add blockchain_addresses field to financial
 account

---
 .stats.yml                            | 4 ++--
 src/lithic/types/financial_account.py | 8 +++++++-
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 8fe8167c..e94c1fb8 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 213
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-1d6c7b672aa49dfe0fe5175965307f63a0ed42c13697b2f9f3b9275f32331937.yml
-openapi_spec_hash: 06e73960c7506484c589d718fa1ddad8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-81febc26f7987ef8f74f2038dddd4799a1e77b2c64d2fe36c2c9f2eb5079476b.yml
+openapi_spec_hash: 91e4b19977ca68b988862e967be57d26
 config_hash: 337a99d8cc30006358b7bc2531401669
diff --git a/src/lithic/types/financial_account.py b/src/lithic/types/financial_account.py
index 28502aef..edfe9ed5 100644
--- a/src/lithic/types/financial_account.py
+++ b/src/lithic/types/financial_account.py
@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 from typing_extensions import Literal
 
@@ -80,4 +80,10 @@ class FinancialAccount(BaseModel):
 
     account_number: Optional[str] = None
 
+    blockchain_addresses: Optional[Dict[str, str]] = None
+    """
+    Provisioned blockchain deposit addresses for this financial account, keyed by
+    the blockchain network that each address belongs to
+    """
+
     routing_number: Optional[str] = None

From 8980c5219db6e83e4cc8e9d2445fbd223c24a728 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 5 Aug 2026 18:52:33 +0000
Subject: [PATCH 3/5] docs(api): clarify CVV format in tokenizations and card

---
 .stats.yml                                       | 4 ++--
 src/lithic/resources/tokenizations.py            | 4 ++--
 src/lithic/types/card.py                         | 2 +-
 src/lithic/types/tokenization_simulate_params.py | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index e94c1fb8..121e1a38 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 213
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-81febc26f7987ef8f74f2038dddd4799a1e77b2c64d2fe36c2c9f2eb5079476b.yml
-openapi_spec_hash: 91e4b19977ca68b988862e967be57d26
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-c150a226e74fdd73925fcba89261022e91a6d4f57dbb305a54063499641427ae.yml
+openapi_spec_hash: 1df81bae378c3cbf265b0fb4cefa2969
 config_hash: 337a99d8cc30006358b7bc2531401669
diff --git a/src/lithic/resources/tokenizations.py b/src/lithic/resources/tokenizations.py
index 34c28a48..7791b518 100644
--- a/src/lithic/resources/tokenizations.py
+++ b/src/lithic/resources/tokenizations.py
@@ -354,7 +354,7 @@ def simulate(
         and merchant tokenization ecosystem.
 
         Args:
-          cvv: The three digit cvv for the card.
+          cvv: The three or four digit CVV for the card. AMEX cards use four digit CVVs.
 
           expiration_date: The expiration date of the card in 'MM/YY' format.
 
@@ -822,7 +822,7 @@ async def simulate(
         and merchant tokenization ecosystem.
 
         Args:
-          cvv: The three digit cvv for the card.
+          cvv: The three or four digit CVV for the card. AMEX cards use four digit CVVs.
 
           expiration_date: The expiration date of the card in 'MM/YY' format.
 
diff --git a/src/lithic/types/card.py b/src/lithic/types/card.py
index 3bb986c2..53c1eae0 100644
--- a/src/lithic/types/card.py
+++ b/src/lithic/types/card.py
@@ -13,7 +13,7 @@ class Card(NonPCICard):
     """
 
     cvv: Optional[str] = None
-    """Three digit cvv printed on the back of the card."""
+    """Three or four digit CVV printed on the card. Amex cards use four digit CVVs"""
 
     pan: Optional[str] = None
     """Primary Account Number (PAN) (i.e.
diff --git a/src/lithic/types/tokenization_simulate_params.py b/src/lithic/types/tokenization_simulate_params.py
index 1b04cf6e..560cda31 100644
--- a/src/lithic/types/tokenization_simulate_params.py
+++ b/src/lithic/types/tokenization_simulate_params.py
@@ -9,7 +9,7 @@
 
 class TokenizationSimulateParams(TypedDict, total=False):
     cvv: Required[str]
-    """The three digit cvv for the card."""
+    """The three or four digit CVV for the card. AMEX cards use four digit CVVs."""
 
     expiration_date: Required[str]
     """The expiration date of the card in 'MM/YY' format."""

From 9c1cfe46e6538c2429653dd65bf72938544f1fe4 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 7 Aug 2026 23:24:26 +0000
Subject: [PATCH 4/5] feat(api): add stablecoin event types to
 payment/statement/financial_event

---
 .stats.yml                                    |  4 ++--
 src/lithic/types/financial_account.py         |  3 ++-
 .../statements/statement_line_items.py        |  3 +++
 src/lithic/types/payment.py                   | 19 ++++++++++++++++---
 src/lithic/types/shared/financial_event.py    |  3 +++
 5 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 121e1a38..3eba8b86 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 213
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-c150a226e74fdd73925fcba89261022e91a6d4f57dbb305a54063499641427ae.yml
-openapi_spec_hash: 1df81bae378c3cbf265b0fb4cefa2969
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-4ea61aa22fa852629c506efa84f633535d32a7133bdf3ae2d09040d2fb6caeb2.yml
+openapi_spec_hash: 76c21b84082530356fe45eed27e84cfe
 config_hash: 337a99d8cc30006358b7bc2531401669
diff --git a/src/lithic/types/financial_account.py b/src/lithic/types/financial_account.py
index edfe9ed5..c738d406 100644
--- a/src/lithic/types/financial_account.py
+++ b/src/lithic/types/financial_account.py
@@ -83,7 +83,8 @@ class FinancialAccount(BaseModel):
     blockchain_addresses: Optional[Dict[str, str]] = None
     """
     Provisioned blockchain deposit addresses for this financial account, keyed by
-    the blockchain network that each address belongs to
+    the full name of the blockchain network that each address belongs to (e.g.
+    `ETHEREUM`)
     """
 
     routing_number: Optional[str] = None
diff --git a/src/lithic/types/financial_accounts/statements/statement_line_items.py b/src/lithic/types/financial_accounts/statements/statement_line_items.py
index 10740060..d62c53bf 100644
--- a/src/lithic/types/financial_accounts/statements/statement_line_items.py
+++ b/src/lithic/types/financial_accounts/statements/statement_line_items.py
@@ -152,8 +152,11 @@ class Data(BaseModel):
         "MONTHLY_REVERSAL",
         "ACCOUNT_TO_ACCOUNT",
         "STABLECOIN_RECEIVED",
+        "STABLECOIN_INITIATED",
         "STABLECOIN_REVIEWED",
+        "STABLECOIN_SENT",
         "STABLECOIN_SETTLED",
+        "STABLECOIN_REJECTED",
     ]
 
     financial_account_token: str
diff --git a/src/lithic/types/payment.py b/src/lithic/types/payment.py
index ee223791..f01cabdd 100644
--- a/src/lithic/types/payment.py
+++ b/src/lithic/types/payment.py
@@ -66,8 +66,11 @@ class Event(BaseModel):
         "WIRE_RETURN_OUTBOUND_SETTLED",
         "WIRE_RETURN_OUTBOUND_REJECTED",
         "STABLECOIN_RECEIVED",
+        "STABLECOIN_INITIATED",
         "STABLECOIN_REVIEWED",
+        "STABLECOIN_SENT",
         "STABLECOIN_SETTLED",
+        "STABLECOIN_REJECTED",
     ]
     """
     Note: Inbound wire transfers are coming soon (availability varies by partner
@@ -127,8 +130,16 @@ class Event(BaseModel):
 
     - `STABLECOIN_RECEIVED` - Stablecoin pay-in received on-chain and pending
       release to available balance.
-    - `STABLECOIN_REVIEWED` - Stablecoin pay-in has completed the review process.
-    - `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance.
+    - `STABLECOIN_INITIATED` - Stablecoin withdrawal initiated, with the funds
+      placed on hold.
+    - `STABLECOIN_REVIEWED` - Stablecoin pay-in or withdrawal has completed the
+      review process.
+    - `STABLECOIN_SENT` - Stablecoin withdrawal accepted for on-chain submission to
+      the destination address, and pending confirmation.
+    - `STABLECOIN_SETTLED` - Stablecoin pay-in funds released to available balance,
+      or stablecoin withdrawal confirmed on-chain.
+    - `STABLECOIN_REJECTED` - Stablecoin withdrawal failed and the hold placed at
+      initiation has been reversed.
     """
 
     detailed_results: Optional[
@@ -150,7 +161,9 @@ class Event(BaseModel):
     """Payment event external ID.
 
     For ACH transactions, this is the ACH trace number. For inbound wire transfers,
-    this is the IMAD (Input Message Accountability Data).
+    this is the IMAD (Input Message Accountability Data). For stablecoin payments,
+    this is the on-chain transaction hash of the transfer; it is present on events
+    that reflect on-chain activity and null on internal lifecycle events.
     """
 
 
diff --git a/src/lithic/types/shared/financial_event.py b/src/lithic/types/shared/financial_event.py
index 2ad57159..9d677eb0 100644
--- a/src/lithic/types/shared/financial_event.py
+++ b/src/lithic/types/shared/financial_event.py
@@ -123,7 +123,10 @@ class FinancialEvent(BaseModel):
             "MONTHLY_REVERSAL",
             "ACCOUNT_TO_ACCOUNT",
             "STABLECOIN_RECEIVED",
+            "STABLECOIN_INITIATED",
             "STABLECOIN_REVIEWED",
+            "STABLECOIN_SENT",
             "STABLECOIN_SETTLED",
+            "STABLECOIN_REJECTED",
         ]
     ] = None

From 00c72452ac4a6d36ff9680060d8e562c08db306a Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 7 Aug 2026 23:24:59 +0000
Subject: [PATCH 5/5] release: 0.131.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 15 +++++++++++++++
 pyproject.toml                |  2 +-
 src/lithic/_version.py        |  2 +-
 4 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 37e99723..a24ae611 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.130.0"
+  ".": "0.131.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 93037f6b..5f9e10dc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.131.0 (2026-08-07)
+
+Full Changelog: [v0.130.0...v0.131.0](https://github.com/lithic-com/lithic-python/compare/v0.130.0...v0.131.0)
+
+### Features
+
+* **api:** add blockchain_addresses field to financial account ([168e194](https://github.com/lithic-com/lithic-python/commit/168e194dce255e6b907a65b3387dffec89ca0426))
+* **api:** Add limit_cash_amount and limit_cash_count to VelocityLimit template ([64068f8](https://github.com/lithic-com/lithic-python/commit/64068f89bd9400b4e684b8eb1fdf5bdede893a36))
+* **api:** add stablecoin event types to payment/statement/financial_event ([9c1cfe4](https://github.com/lithic-com/lithic-python/commit/9c1cfe46e6538c2429653dd65bf72938544f1fe4))
+
+
+### Documentation
+
+* **api:** clarify CVV format in tokenizations and card ([8980c52](https://github.com/lithic-com/lithic-python/commit/8980c5219db6e83e4cc8e9d2445fbd223c24a728))
+
 ## 0.130.0 (2026-07-30)
 
 Full Changelog: [v0.129.0...v0.130.0](https://github.com/lithic-com/lithic-python/compare/v0.129.0...v0.130.0)
diff --git a/pyproject.toml b/pyproject.toml
index beb88420..0df4f166 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "lithic"
-version = "0.130.0"
+version = "0.131.0"
 description = "The official Python library for the lithic API"
 dynamic = ["readme"]
 license = "Apache-2.0"
diff --git a/src/lithic/_version.py b/src/lithic/_version.py
index a8fc2b35..5e23cbfb 100644
--- a/src/lithic/_version.py
+++ b/src/lithic/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "lithic"
-__version__ = "0.130.0"  # x-release-please-version
+__version__ = "0.131.0"  # x-release-please-version