Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 46 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,51 @@
# Changelog

## [1.11.0] - 2026-SEP-01

### Added

#### New API Endpoints

**ApiKey Service**
- **`rotateApiKey()`**: Rotate the invoking API key (`POST /v1/api-keys/rotate`)
- **`ApiKeyRotation.decrypt()`**: Decrypt `encrypted_credentials` with JDK HKDF-SHA256 + AES-256-GCM (no extra libraries)

**Financing Service**
- **`getConversionFees()`**: Get organization conversion fee tiers and month-to-date volume (`GET /v1/conversion/fees`)
- **`getCrossMarginLiquidation()`**: Get detailed XM liquidation data (`GET /v1/entities/{entity_id}/cross_margin/liquidation`)
- **`listCrossMarginLiquidations()`**: List XM liquidation history (`GET /v1/entities/{entity_id}/cross_margin/liquidations`)
- **`getEntityRewardsRate()`**: Get entity rewards rate and tiers (beta) (`GET /v1/entities/{entity_id}/rewards/rate`)
- **`getPortfolioRewardsRate()`**: Get portfolio rewards rate and tiers (beta) (`GET /v1/portfolios/{portfolio_id}/rewards/rate`)

**Futures Service**
- **`getDerivativesCurrencySummary()`**: Get per-currency international derivatives balances (`GET /v1/portfolios/{portfolio_id}/derivatives/currency_summary`)
- **`getDerivativePositions()`**: List active derivative positions for a portfolio (`GET /v1/portfolios/{portfolio_id}/derivatives/positions`)

#### New & Updated Models
- **`ConversionFee`**, **`ConversionFeeTier`**: Stablecoin conversion fee schedule types
- **`XMLiquidationDetail`**, **`XMLiquidationSummary`**, **`XMLiquidatedAsset`**: Cross-margin liquidation types
- **`BetaRewardsRateTier`**: Rewards rate tier (beta)
- **`DerivativePosition`**, **`DerivativesCurrencyBalance`**, **`OptionsDetails`**, **`OptionProductDetails`**: Derivatives product and position types
- **`CustomStablecoinAsset`**, **`ComboLeg`**, **`PriceIncrementStep`**: Supporting product/reward types
- **`Order`**: Added `isBuyExact`
- **`CreateOrderRequest`**, **`GetOrderPreviewRequest`**, **`GetOrderPreviewResponse`**: Added `isBuyExact`
- **`Product`**: Added `optionProductDetails`
- **`TravelRuleParty`**: Added `vaspAddress`
- **`WalletStakeInputs`**: Added `endDate`
- **`WalletUnstakeInputs`**: Added `validatorAddress`
- **`CustomStablecoinRewardDetails`**: Added `asset`

#### New Enums
- **`XMLiquidationStatus`**, **`BetaRewardsRateTierType`**, **`DerivativeProductType`**, **`OptionType`**, **`SettlementModel`**, **`SettlementPeriod`**
- **`ProductType`**: Added `OPTION`
- **`TransactionType`**: Added `MERGE_STAKE`

### Notes

- Minor release: new endpoints including API key rotation, plus regenerated models from the latest OpenAPI spec via **OpenAPI Generator 7.25.0**.
- Model generation skips per-operation typed error-code and subcode enums until the SDK consumes them.
- Rewards rate endpoints are marked beta in the spec.

## [1.10.3] - 2026-JUL-28

### Added
Expand Down
17 changes: 16 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@ The SDK is organized into service interfaces under `com.coinbase.prime.*`, each
| `AddressBookService` | `com.coinbase.prime.addressbook` |
| `AdvancedTransferService` | `com.coinbase.prime.advancedtransfer` |
| `AllocationsService` | `com.coinbase.prime.allocations` |
| `ApiKeyService` | `com.coinbase.prime.apikey` |
| `AssetsService` | `com.coinbase.prime.assets` |
| `BalancesService` | `com.coinbase.prime.balances` |
| `CommissionService` | `com.coinbase.prime.commission` |
Expand Down Expand Up @@ -140,6 +141,20 @@ mvn exec:java -Dexec.mainClass="com.coinbase.examples.transactions.ListPortfolio
- `com.coinbase.examples.wallets.ListWalletAddresses <wallet-id> <network-id>` - List addresses for a wallet
- `com.coinbase.examples.wallets.GetWalletDepositInstructions <wallet-id> [deposit-type]` - Get deposit instructions (deposit-type: CRYPTO, WIRE, SEN, SWIFT, SEPA)

**API Key:**
- `com.coinbase.examples.apikey.RotateApiKey` - Rotate the invoking API key (starts a real rotation). Decrypts `encrypted_credentials` via `ApiKeyRotation.decrypt` using the current `signingKey`.

**Financing:**
- `com.coinbase.examples.financing.GetConversionFees` - Get organization conversion fee tiers
- `com.coinbase.examples.financing.GetCrossMarginLiquidation` - Get XM liquidation details
- `com.coinbase.examples.financing.ListCrossMarginLiquidations` - List XM liquidation history
- `com.coinbase.examples.financing.GetEntityRewardsRate` - Get entity rewards rate (beta)
- `com.coinbase.examples.financing.GetPortfolioRewardsRate` - Get portfolio rewards rate (beta)

**Futures:**
- `com.coinbase.examples.futures.GetDerivativesCurrencySummary` - Get portfolio derivatives currency summary
- `com.coinbase.examples.futures.GetDerivativePositions` - List portfolio derivative positions

**Other:**
- `com.coinbase.examples.Main` - Comprehensive example with multiple API calls

Expand Down Expand Up @@ -170,7 +185,7 @@ The SDK tracks the published Prime OpenAPI definition in **apiSpec/prime-public-
make fetch-spec
```

Models, enums, per-operation request/response types, services, and `PrimeServiceFactory` are **hand-maintained** to match that spec. Example programs under `com.coinbase.examples` ship in the same module and compile with **`mvn compile`**—keep them in sync when the SDK API changes.
Models and enums under `com.coinbase.prime.model` are regenerated from that spec via `tools/model-generator`. Per-operation request/response types, services, and `PrimeServiceFactory` are hand-maintained. Typed error-code / subcode schemas from the spec are skipped for now. Example programs under `com.coinbase.examples` ship in the same module and compile with **`mvn compile`**—keep them in sync when the SDK API changes.

## Changelog

Expand Down
Loading
Loading