API Changelog (2025)

​

Improved Subaccount Transactions with Staking and Delegation Reward Types

• GET /subaccounts/transactions: Now supports filtering and returns the new STAKING_REWARD and DELEGATION_REWARD transaction types.
• GET /subaccounts/transactions/{transactionsIds}: Response transactionType field now includes the new reward types.
• GET /subaccounts/transactions/allocations: Response transactionType field now includes the new reward types.

{
  "data": [
    {
      "transactionId": "c4c4652f-0c07-472c-a7f8-955fbe07775d",
      "transactionType": "STAKING_REWARD",
      "status": "POSTED",
      "createdAt": "2024-08-01T12:00:00.000Z"
    }
  ]
}

​

Improved Rejection Reason for FillOrKill Trading Orders

• POST /trading/order: Response rejectReason now includes InvalidCurrencyForFOK.
• POST /trading/async-order: Response rejectReason now includes InvalidCurrencyForFOK.
• POST /trading/async-order/cancel: Response rejectReason now includes InvalidCurrencyForFOK.

​

Improved Staking Requests with Asset-Specific Parameters

• POST /transactions/stake: The parameters field now accepts a structured object for asset-specific configurations, such as SOL and ETH staking parameters.

​

Added Asset-Specific Staking Parameters

• POST /transactions/stake: Request body now accepts a parameters object supporting stakingProvider (e.g. FIGMENT, BLOCKDAEMON), stakingProviderAddress, stakingPositionId, and validatorType (e.g. 0x01 for Pre-Pectra, 0x02 for Post-Pectra).

​

Added Talos as a Price Source Provider for Collateral Management

• POST /collateral_management/exposures: The priceSourceProvider field within assetTrackingConfig now accepts TALOS as a valid enum value.
• POST /collateral_management/packages: The priceSourceProvider field within collateralAssetsConfig now accepts TALOS as a valid enum value.

​

Improved Stablecoin Conversion Field Descriptions

• POST /stablecoins/conversion: The description for sourceAssetType now states that for issuance the value must be USD, and for redemptions it must be the asset being redeemed; the description for destinationAssetType now states that for issuance the value must be the stablecoin asset, and for redemptions it must be USD.

​

Improved Price Source Configuration for Collateral Management

• POST /collateral_management/packages: Added priceSourceProvider to objects within collateralAssetsConfig; removed KAMINO from priceSource.
• POST /collateral_management/exposures: Added priceSourceProvider to assetTrackingConfig; removed KAMINO from priceSource.

​

Improved Trading Statuses and Tax Tagging Responses

• POST /trading/quote/accept: tradeStatus enum now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/trades: tradeStatus enum now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/trades/{tradeId}: tradeStatus enum now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/settlements/{settlementId}/trades: tradeStatus enum now includes PENDINGALLOCATION and ALLOCATED.
• POST /tax/transaction/{transactionId}/tag: Now returns 202 Accepted to indicate the request is being processed rather than immediately complete.
• DELETE /tax/transaction/{transactionId}/tag: Now returns 202 Accepted to indicate the request is being processed rather than immediately complete.

​

Improved Collateral Management Price Sourcing with KAMINO

• POST /collateral_management/packages: The priceSource field within collateralAssetsConfig now accepts KAMINO.
• POST /collateral_management/exposures: The priceSource field within assetTrackingConfig now accepts KAMINO.

​

Added Price Staleness Configuration for Collateral Packages

• POST /collateral_management/packages: Each object within collateralAssetsConfig now accepts an optional integer maxStalenessMinutes field.

{
  "pledgorId": "...",
  "securedPartyId": "...",
  "collateralAssetsConfig": [
    {
      "asset": {
        "type": "ANCHORAGECUSTODY",
        "assetType": "BTC"
      },
      "weight": "0.85",
      "liquidationPriority": 1,
      "maxStalenessMinutes": 5
    }
  ],
  "priceStrategy": "DEFAULT"
}

​

Improved Vesting Balances Response with Asset Context

• GET /vesting/balances/{allocationId}: The balance object in the response now contains two new required fields: externalTokenId (the asset ID assigned by the external provider) and networkId (the blockchain network identifier).

​

Improved Trading Status Clarity and Added Tax Transaction Tagging

• POST /tax/transaction/{transactionId}/tag: Adds a tag to a transaction for tax purposes.
• DELETE /tax/transaction/{transactionId}/tag: Removes a tag from a transaction.

• POST /trading/quote: quoteStatus description clarified.
• POST /trading/quote/accept: quoteStatus and tradeStatus descriptions clarified; tradeStatus now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/trades: tradeStatus description clarified and expanded.
• GET /trading/trades/{tradeId}: tradeStatus description clarified and expanded.
• GET /trading/settlements/{settlementId}/trades: tradeStatus description clarified and expanded.

​

Added stakeholderId Parameter to Vesting Balances Endpoint

• GET /vesting/balances/{allocationId}: New optional stakeholderId query parameter can be used to retrieve wallet information for a stakeholder.

​

Improved API Key Permissions with FIAT_BANKING

• GET /apikey: Response may now include FIAT_BANKING as a value in the permission field within the permissions array.

{
  "data": {
    "id": "b5a58566763e77e2d87a53463013981be7c0b048c1c0dd39ba44e77c99bc1351",
    "permissions": [
      {
        "permission": "READ",
        "vaultIds": [
          "1c920f4241b78a1d483a29f3c24b6c4c"
        ]
      },
      {
        "permission": "FIAT_BANKING"
      }
    ]
  }
}

​

Improved Parameter Descriptions for Delegation Addresses

• GET /delegation-addresses/{assetType}: Descriptions for the assetType, afterId, and limit parameters have been improved.

​

Added Endpoint for Listing Delegation Addresses

• GET /delegation-addresses/{assetType}: Retrieves a list of supported delegation addresses for a specific asset type.

​

Improved Delegation Address Details with Validator Information

• GET /delegation-addresses/{assetType}: Each address object in the data array now includes two new required fields: anchorageValidator (boolean) and validatorType (string).

{
  "data": [
    {
      "address": "...",
      "name": "Validator Name",
      "anchorageValidator": true,
      "validatorType": "ENTERPRISE"
    }
  ]
}

​

Improved Collect Requests by Making Amount Optional

• POST /transactions/collect: The amount property is no longer required.

​

Added Endpoint to List Delegation Addresses

• GET /delegation-addresses/{assetType}: Lists supported delegation addresses for the specified asset type.

curl --request GET \
  --url 'https://api.anchorage.com/v2/delegation-addresses/ETH' \
  --header 'Api-Access-Key: <YOUR_API_KEY>'

​

Added Endpoint to Update Customer Onboarding Applications

• PUT /onboarding/customers/{customerId}: Updates the data of an existing customer onboarding application by accepting an entries array of key-value pairs.

PUT /onboarding/customers/{customerId}
Content-Type: application/json

{
  "entries": [
    {
      "key": "contactEmail",
      "value": "new.email@example.com"
    }
  ]
}

​

Improved Collateral Exposures by Making Weight Optional

• POST /collateral_management/exposures: The weight field in assetTrackingConfig is no longer required.

​

Improved Trading Statuses and Staking Full-Amount Operations

• POST /trading/quote: quoteStatus enum updated to consistently reflect the quote lifecycle (OPEN, REJECTED, EXECUTED).
• POST /trading/quote/accept: tradeStatus now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/trades: tradeStatus now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/trades/{tradeId}: tradeStatus now includes PENDINGALLOCATION and ALLOCATED.
• GET /trading/settlements/{settlementId}/trades: tradeStatus now includes PENDINGALLOCATION and ALLOCATED.
• POST /transactions/unstake: The isFullAmount parameter description clarified to indicate it overrides any provided amount.
• POST /transactions/collect: New isFullAmount boolean parameter added.

​

Improved Staking Position Data and Trading Status Descriptions

• GET /wallets/{walletId}/staking/positions: Response now includes the numeric inactiveStakedAmount field (excluding units).
• POST /trading/quote: quoteStatus description clarified.
• POST /trading/quote/accept: quoteStatus and tradeStatus descriptions clarified, including the PENDINGALLOCATION and ALLOCATED states.
• GET /trading/trades: tradeStatus description clarified.
• GET /trading/trades/{tradeId}: tradeStatus description clarified.
• GET /trading/settlements/{settlementId}/trades: tradeStatus description clarified.

​

Improved Tax Form Responses with Additional Details

• GET /tax/subaccounts/{subaccountId}/forms: Each form object now includes id, createdDate, year, revision, revisionType, and isFiled fields.
• GET /tax/clients/{customerId}/forms: Each form object now includes id, createdDate, year, revision, revisionType, and isFiled fields.

{
  "data": [
    {
      "subaccountId": "your-subaccount-id",
      "forms": [
        {
          "formType": "1099B",
          "downloadLink": "https://api.anchorage.com/download/link",
          "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
          "createdDate": "2023-02-10T08:30:00Z",
          "year": 2022,
          "revision": 1,
          "revisionType": "Original",
          "isFiled": true
        }
      ]
    }
  ]
}

​

Improved Descriptions for Creating Trusted Destinations

• POST /trusted_destinations: Descriptions for the trustedDestinations array and the name property within array items have been improved.

​

Improved Collect Request Body with Source and Idempotency

• POST /transactions/collect: Request body now requires a source object specifying the wallet to collect from, and adds optional description and idempotentId fields. The 201 Created response now returns an application/json payload.

​

Improved Error Handling for Asynchronous Orders

• POST /trading/async-order: Response rejectReason now includes InvalidAccountsInAllocation.
• POST /trading/async-order/cancel: Response rejectReason now includes InvalidAccountsInAllocation.

​

Improved Stablecoin Conversion Creation Response

• POST /stablecoins/conversion: The response now returns a required authorizationOperationId instead of conversionId; conversionId is now optional in the response.

​

Improved Collateral Management with Interest Paydown and Accrual Actions

• PATCH /collateral_management/operations/{operationId}: action field now supports INTEREST_PAYDOWN and INTEREST_ACCRUAL.
• POST /collateral_management/operations: action field now supports INTEREST_PAYDOWN and INTEREST_ACCRUAL.
• GET /collateral_management/operations: action field in responses now supports INTEREST_PAYDOWN and INTEREST_ACCRUAL.

​

Added Endpoints for Retrieving Account Statements

• GET /statement-types: Lists available statement types.
• GET /statements: Lists generated statements for your account.
• GET /statements/{statementId}: Gets details for a specific statement by its ID.
• GET /statements/{statementId}/download: Downloads a specific statement file.

​

Added Webhook Notifications for Real-Time Event Updates

• GET /webhook/validation-key: Retrieves the key used to validate webhook payload signatures.
• GET /webhook/event-types: Lists all available event types you can subscribe to.
• POST /webhook/endpoints: Creates a new webhook endpoint.
• GET /webhook/endpoints: Lists your webhook endpoints.
• GET /webhook/endpoints/{endpointId}: Gets a specific webhook endpoint.
• PATCH /webhook/endpoints/{endpointId}: Updates a webhook endpoint.
• POST /webhook/endpoints/{endpointId}/subscriptions: Subscribes an endpoint to an event type.
• GET /webhook/endpoints/{endpointId}/subscriptions: Lists an endpoint’s event subscriptions.
• DELETE /webhook/endpoints/{endpointId}/subscriptions/{eventTypeId}: Removes an endpoint’s subscription to an event type.

[
  {
    "url": "https://your-domain.com/transaction-webhooks",
    "description": "Endpoint for receiving transaction event webhooks",
    "subscriptions": [
      {
        "eventTypeId": "withdrawal.initiated"
      }
    ],
    "publicKey": "-----BEGIN PUBLIC KEY-----\nMFYwEAYHKoZIzj0CAQYFK4EEAAoDQgAEeg+pxTCsjew/+7IK4+Vw5zyHDnMW7bzn\nsClhuYIKjXF8EJ1lfyZC2VPVullBKgvHRzNMfC1KkF2LIoRp2ibcWQ==\n-----END PUBLIC KEY-----"
  }
]

​

Improved Trading Orders with Subaccount Allocation Details

• POST /trading/async-order: Request body now accepts an allocation array specifying how the order should be allocated across subaccounts.
• POST /trading/async-order/cancel: Response now includes a detailed allocation object.
• POST /trading/order: Response now includes a detailed allocation object.
• GET /trading/orders: Response now includes a detailed allocation object.
• GET /trading/orders/{orderId}: Response now includes a detailed allocation object.

"allocation": [
  {
    "subaccountId": "343b6c83-6d91-4f13-9982-2109abd2dbb0",
    "quantity": "5000.00"
  },
  {
    "subaccountId": "905272f0-52f9-404e-b6cd-ad879e671790",
    "quantity": "5000.00"
  }
]

​

Improved Gas Station Fee Option for Transfers and Withdrawals

• POST /transactions/withdrawal: The optional boolean useGasStation field is now more clearly documented.
• POST /transfers: The optional boolean useGasStation field is now more clearly documented.

{
  "assetType": "ETH",
  "amount": "5.0",
  "idempotentId": "e8a7f9b0-9c8d-4e6f-a1b2-c3d4e5f6a7b8",
  "source": {
    "id": "1c920f4241b78a1d483a29f3c24b6c4c",
    "type": "WALLET"
  },
  "destination": {
    "id": "0x1234567890123456789012345678901234567890",
    "type": "ADDRESS"
  },
  "useGasStation": true
}

​

Added Collect Endpoint and Improved Staking Operations

• POST /transactions/collect: Creates a collect request.

• POST /transactions/stake: Request body now accepts an optional boolean isFullAmount field.
• POST /transactions/unstake: Request body now accepts an optional boolean isFullAmount field.

​

Added LTV Rounding Precision to Collateral Package Creation

• POST /collateral_management/packages: Request body now accepts an optional ltvRoundingPrecision field.

​

Improved Stablecoin Conversion Request Body

• POST /stablecoins/conversion: Removed the optional decimalAmount and idempotentId fields; added required fields amount (string) and idempotencyKey (string).

{
  "decimalAmount": "100.00",
  "idempotentId": "some-uuid-v4-string"
}

{
  "amount": "100.00",
  "idempotencyKey": "your-unique-key-string"
}

​

Improved Trading and Quote Status Descriptions

• POST /trading/quote: quoteStatus description expanded.
• POST /trading/quote/accept: tradeStatus and quoteStatus descriptions expanded.
• GET /trading/settlements/{settlementId}/trades: tradeStatus description expanded.
• GET /trading/trades: tradeStatus description expanded.
• GET /trading/trades/{tradeId}: tradeStatus description expanded.

​

Improved Trading API Documentation Clarity

• GET /trading/accounts/{accountId}: Clarified 404 Not Found response description.
• POST /trading/async-order: Description clarity improvements.
• POST /trading/order: Description clarity improvements.
• GET /trading/pairs: Enhanced description of the referenceData object.
• POST /trading/quote: Added comprehensive request body examples for BUY, SELL, and TWOWAY scenarios; clarified quoteStatus description.
• POST /trading/quote/accept: Improved description of allowedSlippage and vaultID, including a detailed example of how allowedSlippage functions.
• GET /trading/settlements/{settlementId}/trades: Clarified tradeStatus and settlementStatus descriptions and the 404 Not Found response.
• GET /trading/trades: Clarified tradeStatus description.
• GET /trading/trades/{tradeId}: Clarified tradeStatus description.
• GET /trading/settlements: Clarified settlementStatus description.
• GET /trading/settlements/{settlementId}: Clarified settlementStatus description; updated price field description to explain its composition and asynchronous availability.

​

Improved Async Order Rejection with OrderNotCancelable Reason

• POST /trading/async-order: rejectReason now includes OrderNotCancelable.
• POST /trading/async-order/cancel: rejectReason now includes OrderNotCancelable.

​

Improved Transaction Filtering with New Reward Types

• GET /transactions: The types query parameter now accepts DELEGATION_REWARD, STAKING_REWARD, RESTAKING_REWARD, and ALLUVIAL_STAKING_REWARD.

GET /v2/transactions?types=STAKING_REWARD,DELEGATION_REWARD

​

Added Atlas Settlement Network, Collateral Management, Stablecoins, Tax, Trusted Destinations, and Webhook Endpoints

• GET /atlas/directory/counterparties: Lists counterparties on the Atlas Settlement Network.
• GET /atlas/directory/counterparties/{counterpartyId}: Gets a specific counterparty.
• GET /atlas/directory/participants: Lists participants on the Atlas Settlement Network.
• POST /atlas/settlements: Proposes a new settlement.
• GET /atlas/settlements: Lists settlements.
• GET /atlas/settlements/{settlementId}: Gets a specific settlement.
• POST /atlas/settlements/{settlementId}/accept: Accepts a settlement proposal.
• POST /atlas/settlements/{settlementId}/authorize: Authorizes a settlement.
• POST /atlas/settlements/{settlementId}/reject: Rejects a settlement proposal.
• GET /collateral_management/exposures: Lists collateral exposures.
• POST /collateral_management/exposures: Creates a collateral exposure.
• GET /collateral_management/operations: Lists collateral operations.
• POST /collateral_management/operations: Creates a collateral operation.
• PATCH /collateral_management/operations/{operationId}: Updates a collateral operation.
• GET /collateral_management/packages: Lists collateral packages.
• POST /collateral_management/packages: Creates a collateral package.
• PATCH /collateral_management/packages/{packageId}: Updates a collateral package.
• POST /stablecoins/conversion: Creates stablecoin conversions, including issuance and redemption.
• GET /tax/inventory/summary/{subaccountId}, PATCH /tax/transaction/{transactionId}, GET /tax/clients/{customerId}/forms, and more: A full suite of endpoints to fetch tax transactions, gains, inventory, and forms, and to update cost basis.
• GET /trusted_destinations, POST /trusted_destinations, DELETE /trusted_destinations/{creationRequestId}/cancel, and more: Create, list, and manage the lifecycle of trusted destinations.
• GET /webhook/endpoints: Lists webhook endpoints.
• POST /webhook/endpoints: Creates a webhook endpoint.
• GET /webhook/endpoints/{endpointId}: Gets a webhook endpoint.
• PATCH /webhook/endpoints/{endpointId}: Updates a webhook endpoint.
• GET /webhook/endpoints/{endpointId}/subscriptions: Lists an endpoint’s subscriptions.
• POST /webhook/endpoints/{endpointId}/subscriptions: Subscribes an endpoint to an event type.
• DELETE /webhook/endpoints/{endpointId}/subscriptions/{eventTypeId}: Removes an event subscription.
• GET /webhook/event-types: Lists available webhook event types.
• GET /webhook/validation-key: Retrieves the webhook payload validation key.

• GET /vaults, POST /vaults/{vaultId}/wallets, GET /wallets, GET /wallets/{walletId}/staking/positions, GET /wallets/{walletId}/staking/rewards: Expanded for comprehensive listing and creation, including access to staking data.
• GET /vaults/{vaultId}/addresses, POST /wallets/{walletId}/addresses: Expanded to list and provision new deposit addresses.
• POST /transactions/stake, POST /transactions/unstake, POST /transactions/withdrawal: Expanded to initiate staking and withdrawal operations.
• POST /transfers, GET /transfers, DELETE /transfers/{transferId}: Expanded to create, list, and cancel automated asset transfers.

​

Added 422 Error Response for Collateral Exposure Creation

• POST /collateral_management/exposures: May now return a 422 Unprocessable Entity response when a request is syntactically correct but cannot be processed due to semantic or business logic errors.

​

Added Endpoint for Stablecoin Conversions

• POST /stablecoins/conversion: Creates a stablecoin conversion.

​

Added Trusted Destination Support for Transfers and Withdrawals

• POST /transfers: destination.type now accepts TRUSTED_DESTINATION.
• POST /transactions/withdrawal: destination.type now accepts TRUSTED_DESTINATION.
• GET /transfers: Response now reflects the TRUSTED_DESTINATION destination type.
• GET /transfers/{transferId}: Response now reflects the TRUSTED_DESTINATION destination type.

{
  "assetType": "BTC",
  "amount": "1.5",
  "source": {
    "id": "3d293c0d64c703023692216e9b4f5280",
    "type": "WALLET"
  },
  "destination": {
    "id": "d1ae1416-ebd7-11ea-adc1-0242ac120002",
    "type": "TRUSTED_DESTINATION"
  }
}

​

Improved Tax Inventory Response Field Casing

• GET /tax/inventory/{subaccountId}/{assetTypeId}: Response field renamed from AverageUnitCost to averageUnitCost.

{
  "AverageUnitCost": "50000.00"
}

{
  "averageUnitCost": "50000.00"
}

​

Improved API Key Permissions and Signature Documentation

• GET /apikey: Response permissions array may now include the new CONVERT_STABLECOINS permission.
• POST /transactions/stake: Api-Signature header documentation clarified.
• POST /transactions/unstake: Api-Signature header documentation clarified.

​

Added Wallet Search by Address

• GET /wallets: New searchByAddress query parameter, requiring a minimum of 3 characters.

GET /v2/wallets?searchByAddress=0xAbC123

​

Added Strategy Parameters to Trading Order Responses

• GET /trading/orders: Response now includes a strategyParams object containing triggerPrice and endTime for applicable order types.
• GET /trading/orders/{orderId}: Response now includes a strategyParams object containing triggerPrice and endTime for applicable order types.

​

Improved Error Handling for Collateral Package Creation

• POST /collateral_management/packages: May now return a 422 Unprocessable Entity response.

​

Added Endpoint to Cancel Trusted Destination Creation

• DELETE /trusted_destinations/{creationRequestId}/cancel: Cancels a pending Trusted Destination creation request. The creationRequestId corresponds to the idempotentId provided in the initial POST /trusted_destinations request.

​

Improved Standardization of rejectReason Enum for Async Orders

• POST /trading/async-order: rejectReason enum standardized — removed ErrInvalidLimitPriceForSell, ErrInvalidLimitPriceForBuy, ErrInvalidTriggerPrice, and ErrInvalidLimitPrice; added InvalidLimitPrice and InvalidTriggerPrice.
• POST /trading/async-order/cancel: Same rejectReason enum changes as above.

​

Improved Async Order Rejection with ErrInvalidLimitPrice Reason

• POST /trading/async-order: rejectReason now includes ErrInvalidLimitPrice.
• POST /trading/async-order/cancel: rejectReason now includes ErrInvalidLimitPrice.

​

Improved Subaccount Balances with Detailed Entry Breakdown

• GET /subaccounts/customers/accounts: Each object in the balances array now contains an entries array, with each entry providing an amount and description for a component of the total balance (e.g., Posted, Pending).
• GET /subaccounts/customers/{customerId}/accounts: Same entries addition to the balances array.

"balances": [
  {
    "assetType": "USD",
    "totalBalance": "1000.00",
    "entries": [
      {
        "amount": "950.00",
        "description": "Posted Balance"
      },
      {
        "amount": "50.00",
        "description": "Pending Balance"
      }
    ]
  }
]

​

Deprecated VAULT Resource Type for Transfers and Withdrawals

• POST /transactions/withdrawal: source.type/destination.type no longer accept VAULT; use WALLET.
• POST /transfers: source.type/destination.type no longer accept VAULT; use WALLET.
• GET /transfers: Response reflects that wallet resource type is always WALLET.
• GET /transfers/{transferId}: Response reflects that wallet resource type is always WALLET.
• GET /vaults: Response reflects the deprecation.
• GET /vaults/{vaultId}: Response reflects the deprecation.
• GET /vaults/{vaultId}/wallets: Response reflects the deprecation.
• POST /vaults/{vaultId}/wallets: Response reflects the deprecation.
• GET /wallets: Response reflects that wallet resource type is always WALLET.
• GET /wallets/{walletId}: Response reflects that wallet resource type is always WALLET.

{
  "source": {
    "id": "1c920f4241b78a1d483a29f3c24b6c4c",
    "type": "VAULT"
  }
}

{
  "source": {
    "id": "3d293c0d64c703023692216e9b4f5280",
    "type": "WALLET"
  }
}

​

Improved Trusted Destinations Response Structure

• GET /trusted_destinations: owners array replaced with an owner object; added name and description fields.

{
  "id": "td_123",
  "owners": ["cust_abc"]
}

{
  "id": "td_123",
  "name": "My Destination",
  "description": "Coinbase wallet",
  "owner": {
    "id": "cust_abc",
    "type": "CUSTOMER"
  }
}

​

Improved Async Order Parameters and Content Type

• POST /trading/async-order: Request body content type changed to application/json. The parameters property is now specifically for STOP_LOSS, STOP_LIMIT, and TAKE_PROFIT_LIMIT order types, including optional endTime and required triggerPrice parameters.

​

Improved Wallet Filtering Parameter Naming

• GET /vaults/{vaultId}/wallets: assetTypeId query parameter replaced with assetType.
• GET /wallets: assetTypeId query parameter replaced with assetType.

​

Added networkId and assetTypeId Filters to Wallet Endpoints

• GET /vaults/{vaultId}/wallets: New optional networkId and assetTypeId query parameters filter results to wallets matching the given network or asset type.
• GET /wallets: New optional networkId and assetTypeId query parameters filter results to wallets matching the given network or asset type.

​

Added Endpoint to Update Collateral Packages

• PATCH /collateral_management/packages/{packageId}: Updates an existing collateral package.

​

Added RFQ Order Type to Trading Endpoints

• GET /trading/orders: orderType field in responses now includes RFQ as a possible value.
• GET /trading/orders/{orderId}: orderType field in responses now includes RFQ as a possible value.

​

Added Expired Status to Trusted Destinations Workflow

• GET /trusted_destinations/{creationRequestId}/status: status field may now return Expired.

​

Added Collateral Exposures Endpoint and Updated Collateral Packages

• POST /collateral_management/exposures: Creates a collateral exposure.

• POST /collateral_management/packages: Removed the required internalName property; changed the collateralAssetsConfig array.

​

Added internalName and priceStrategy to Collateral Package Creation

• POST /collateral_management/packages: Request body now accepts an optional internalName (string) for internal tracking, and requires a priceStrategy (string) field specifying the pricing strategy, with DEFAULT as a valid enum value.

​

Added Collateral Package Creation and Improved Package Retrieval

• POST /collateral_management/packages: Creates a new collateral package.

• GET /collateral_management/packages: The acceleratedMarginCall and critical objects now include returnToLtv and warningLtv properties, with the critical object now required; the action enum for these objects now includes NONE, PARTIAL, FULL, and SWEEP. The marginCall object adds curePeriod, curePeriodProtection, and topUpType properties with the same expanded action enum. The marginReturn object adds a returnToLtv property with an action enum of NONE and SWEEP.

​

Added GAS_STATION Transaction Type

• GET /transactions: transactionType field now includes GAS_STATION.
• GET /transactions/{transactionId}: transactionType field now includes GAS_STATION.

​

Added Owners Field to Trusted Destinations Response

• GET /trusted_destinations: Each object in the data array now includes an owners field, an array of strings representing the owners of the trusted destination.

{
  "data": [
    {
      "id": "some-id",
      "type": "crypto",
      "crypto": {
        "address": "some-address",
        "networkId": "some-network",
        "assetType": "some-asset",
        "isNetworkLevel": false
      },
      "owners": ["owner1", "owner2"]
    }
  ],
  "page": {
    "next": null
  }
}

​

Added REHYPE_IN and REHYPE_OUT Actions for Collateral Management

• POST /collateral_management/operations: action field now supports REHYPE_IN and REHYPE_OUT.
• PATCH /collateral_management/operations/{operationId}: action field now supports REHYPE_IN and REHYPE_OUT.
• GET /collateral_management/operations: action field in responses now supports REHYPE_IN and REHYPE_OUT.

​

Improved Trusted Destination Status Granularity

• GET /trusted_destinations/{creationRequestId}/status: status field now returns one of Initiated, Generating Docusign, Pending DocuSign Signature, Trusted Destination Operation In Progress, Needs Quorum Approval, Anchorage Risk Review, Linking Trusted Destination, Complete, Failed, Rejected, or Canceled.

​

Added Vesting Balances Endpoint

• GET /vesting/balances/{allocationId}: Retrieves vesting balances for a given allocation.

​

Added Async Order Endpoint and Expanded Order Types

• POST /trading/async-order: Places an async order (Market or Limit; currently only FillOrKill is supported). One of accountId or subaccountId must be specified, but not both.
• POST /trading/async-order/cancel: Cancels an async order.

• GET /trading/orders: orderType now includes STOP_LIMIT, TAKE_PROFIT_LIMIT, STOP_LOSS, TWAP, VWAP, PEGGED, POV, and OTHER; orderStatus now includes PENDING_CANCEL.
• GET /trading/orders/{orderId}: orderType now includes STOP_LIMIT, TAKE_PROFIT_LIMIT, STOP_LOSS, TWAP, VWAP, PEGGED, POV, and OTHER.

​

Improved Webhook Endpoints with Public Key Support

• GET /webhook/endpoints: Response now includes a publicKey property for each endpoint.
• POST /webhook/endpoints: Request body now accepts an optional publicKey field.
• GET /webhook/endpoints/{endpointId}: Response now includes a publicKey property.
• PATCH /webhook/endpoints/{endpointId}: Request body now accepts a publicKey property, allowing it to be updated.
• GET /apikey: permissions array now supports a new CONFIGURE_WEBHOOKS permission, which controls access to webhook configuration endpoints.

​

Added Trusted Destinations Status Endpoint

• GET /trusted_destinations/{creationRequestId}/status: Retrieves the status of a Trusted Destination creation request, using the creationRequestId path parameter (the idempotent ID provided in the Create Trusted Destination request).

GET /trusted_destinations/1ca86e65-4340-4876-85f4-8334852b9c43/status

​

Added Create Allocations Endpoint for Wealth Management

• POST /subaccounts/transactions/allocations: Creates new allocations between subaccounts of the same Program Customer. This is a transactional operation — either all allocations are created successfully, or none are. A maximum of 100 allocations and 10 unique assets per request are enforced. If allocations are successfully created, any relevant pending subaccount transactions are updated to reflect them.

{
  "allocations": [
    {
      "sourceSubaccountId": "source_subaccount_id_1",
      "destinationSubaccountId": "destination_subaccount_id_1",
      "assetType": "BTC",
      "amount": "1.5"
    },
    {
      "sourceSubaccountId": "source_subaccount_id_2",
      "destinationSubaccountId": "destination_subaccount_id_2",
      "assetType": "ETH",
      "amount": "10"
    }
  ]
}

​

Improved Withdrawal Requests with Trusted Destination AML Support

• POST /transactions/withdrawal: beneficiary and destination AML fields are now fully optional (not deprecated). A new optional boolean field, useTrustedDestinationAml (default false), lets the caller indicate the system should use the associated Trusted Destination’s AML information instead of resubmitting it. A new SUBACCOUNT source type is supported, with originator information auto-populated for Wealth Management clients. For joint accounts, source.customerId is now mandatory, and the AML questionnaire’s purpose field is now required.

POST /v2/transactions/withdrawal
{
  "source": {
    "id": "4521431f758f18cab818ea4461a01ed7",
    "type": "VAULT"
  },
  "assetType": "ETH",
  "destination": {
    "id": "0x3F431f6259d8bCAa0695153bd141aF7265d086cd",
    "type": "ADDRESS"
  },
  "amount": "1",
  "description": "",
  "withdrawalAmlQuestionnaire": {
    "useTrustedDestinationAml": true,
    "purpose": "REBALANCE",
    "originatorType": "MY_ORGANIZATION"
  }
}

POST /v2/transactions/withdrawal
{
  "source": {
    "id": "15bb8b12-d991-45d2-b784-c83c4449265b",
    "type": "SUBACCOUNT"
  },
  "assetType": "ETH",
  "destination": {
    "id": "0x3F431f6259d8bCAa0695153bd141aF7265d086cd",
    "type": "ADDRESS"
  },
  "amount": "1",
  "description": "",
  "withdrawalAmlQuestionnaire": {
    "useTrustedDestinationAml": true,
    "purpose": "REBALANCE"
  }
}

​

Added Endpoint to Create Trusted Destinations

• POST /trusted_destinations: Creates one or more trusted destination addresses (up to 10 per request). Each destination applies to a specific asset address, or to any asset on a network when isNetworkLevel is true (e.g., ETH and USDC could both be withdrawn to an ETH address); when false, only the specified asset can be withdrawn to that address. For Wealth Management integrations, the destination can be tied to an owner representing a Wealth Management CUSTOMER.

{
  "idempotentId": "YOUR_GENERATED_UUID_HERE",
  "trustedDestinations": [
    {
      "assetType": "ETH",
      "address": "0x430EF7FAB8e10dFb8B7c50c2026d0e247FEE4B8",
      "name": "Test Ethereum Address 3",
      "trustedDestinationAmlQuestionnaire": {
        "destinationType": "SELFHOSTED_WALLET",
        "selfhostedDescription": "Personal ETH wallet for testing",
        "selfhostedWalletOwner": "PERSON_OR_ENTITY",
        "recipientType": "PERSON",
        "recipientFirstName": "John",
        "recipientLastName": "Doe",
        "recipientFullName": "John Doe",
        "recipientCountry": "US",
        "recipientStreetAddress": "123 Main St",
        "recipientCity": "San Francisco",
        "recipientStateProvince": "CA",
        "recipientPostalCode": "94105"
      },
      "description": "Test Ethereum wallet for demo purposes",
      "memo": "ETH demo wallet 3",
      "isNetworkLevel": false
    },
    {
      "assetType": "ETH",
      "address": "0x3088D00C2CF28327DF06E53CA6D6A3b5642534bA",
      "name": "Test Ethereum Address 4",
      "trustedDestinationAmlQuestionnaire": {
        "destinationType": "SELFHOSTED_WALLET",
        "selfhostedDescription": "Organization ETH_R wallet",
        "selfhostedWalletOwner": "MY_ORGANIZATION",
        "recipientType": "MY_ORGANIZATION",
        "recipientFullName": "Demo Company Inc",
        "recipientCountry": "US",
        "recipientStreetAddress": "1 Market St",
        "recipientCity": "San Francisco",
        "recipientStateProvince": "CA",
        "recipientPostalCode": "94105"
      },
      "description": "Test ETH",
      "memo": "ETH wallet",
      "isNetworkLevel": true
    }
  ],
  "owner": {
    "type": "CUSTOMER",
    "id": "7266559476aac38fc8c7c2022f93a9d1b9b618b1c9e2b4387840b595dcd374aa"
  }
}

​

Added Placeholder Template Entry

​

Added Client Account Onboarding Endpoints and Updated KYC Requirements

• POST /onboarding/accounts: Creates a new client account (e.g., IRA, ROTH, JOINT, CUSTODIAL, INDIVIDUAL_TAXABLE, INSTITUTIONAL_TAXABLE), referencing one or more existing program customers, signers, beneficiaries, and fee configurations.
• GET /onboarding/accounts/{subaccountId}: Retrieves a client account application.
• PUT /onboarding/accounts/{subaccountId}: Updates a client account application.
• POST /onboarding/accounts/{subaccountId}/submit: Submits a client account application for review.

• POST /onboarding/customers: For individuals, physicalStateUS/physicalStateOther are now conditionally required based on physicalCountry, a new idType field (GOVERNMENT_ISSUED_ID_CARD or PASSPORT) determines required identity document uploads, and initialFundingMethod, sourceOfWealth, and initialFundingWalletGroup have been removed. For institutions, physicalStateUS/physicalStateOther are similarly conditional, new hasDbaName/dbaNames and constitutionDocument/proofOfAddress fields were added, and legalStructure, customerType, countryOfIncorporation, legalRegistAddrDifPrincPlace (and its related address fields), initialFundingWalletGroup, and sourceOfWealth have been removed.

{
    "name": "{{name}}",
    "externalId": "{{externalId}}",
    "submit": true,
    "entries": [
        { "key": "legalEntityName", "value": "SubAccount JOINT" },
        { "key": "accountType", "value": "JOINT" },
        { "key": "documentPreferenceAddressDefaultEmail", "value": "kevin.flynn_4@test.com" },
        { "key": "programSignerGroup", "value": [
                {
                    "programSignerFirstName": "Kevin",
                    "programSignerLastName": "Flynn_5",
                    "programSignerEmail": "kevin.flynn_5@test.com",
                    "termsAgreementId": "tersmAgreementId"
                },
                {
                    "programSignerFirstName": "Kevin",
                    "programSignerLastName": "Flynn_6",
                    "programSignerEmail": "kevin.flynn_6@test.com",
                    "termsAgreementId": "tersmAgreementId"
                }
            ]
        },
        { "key": "programCustomers", "value": [
                {
                    "programCustomerId": "{{customerId1}}",
                    "programCustomerRole": "PRIMARY"
                },
                {
                    "programCustomerId": "{{customerId2}}",
                    "programCustomerRole": "SECONDARY"
                }
            ]
        },
        { "key": "beneficiaryGroup", "value": [
                {
                    "beneficiaryType": "SPOUSE",
                    "beneficiaryName": "Test beneficiary",
                    "beneficiaryAllocation": "50"
                },
                {
                    "beneficiaryType": "CHARITY",
                    "beneficiaryName": "Test beneficiary 2",
                    "beneficiaryAllocation": "50"
                }
            ]
        },
        { "key": "fees", "value": [
                {
                    "feeType": "ADVISORY",
                    "feeRate": "0.1"
                },
                {
                    "feeType": "MANAGEMENT",
                    "feeRate": "0.25",
                    "feeIsBillable": true
                }
            ]
        }
    ]
}

​

Added Detailed Level Configuration to Collateral Packages Response

• GET /collateral_management/packages: Response now includes marginReturn, marginCall, acceleratedMarginCall, and critical objects, each containing properties such as ltv, action, returnToLtv, warningLtv, and defaultNotice.

​

Improved transactionId Parameter for Subaccount Tax Transactions

• PATCH /tax/transaction/{transactionId}: Now requires the use of the ledger transactionId rather than the previous tax transaction id (the Taxbit unique identifier).

​

Deprecated participantId Parameter on Atlas Settlement Rejection

• POST /atlas/settlements/{settlementId}/reject: The participantId query parameter has been removed.

​

Added InvalidPrice Reject Reason to Trading Orders

• POST /trading/order: rejectReason now includes InvalidPrice, providing a more specific reason for order rejection when the provided price is invalid.

​

Improved Subaccount Transaction Balances Structure

• GET /subaccounts/transactions: amounts.balances array replaces hold/pending/posted properties.
• GET /subaccounts/transactions/{transactionsIds}: amounts.balances array replaces hold/pending/posted properties.

{
  "transactionId": "c4c4652f-0c07-472c-a7f8-955fbe07775d",
  "subaccounts": [
    {
      "subaccountId": "ec761b5e-fd2c-497a-a9a0-f8738ac97bdf",
      "amounts": [
        {
          "assetType": "BTC",
          "balances": [
            {
              "amount": "1000.00",
              "balanceType": "POSTED"
            },
            {
              "amount": "500.00",
              "balanceType": "HOLD"
            }
          ]
        }
      ]
    }
  ]
}

​

Improved Tax Forms Endpoint with Customer-Based Lookup

• GET /tax/clients/{customerId}/forms: Path changed from /tax/clients/{affiliateId}/forms; the affiliateId path parameter was removed and replaced with customerId.

curl --request GET \
     --url https://api.anchorage-staging.com/v2/tax/clients/{customerId}/forms \
     --header 'accept: application/json'

​

Deprecated Destination and Beneficiary AML Fields for Transfers

• POST /transfers: Within transferAmlQuestionnaire, the following Destination fields are deprecated: destinationType, institutionName, institutionCountry, selfhostedDescription. The following Beneficiary fields are deprecated: recipientType, recipientFirstName, recipientLastName, recipientFullName, recipientCountry, recipientStreetAddress, recipientCity, recipientStateProvince, recipientPostalCode.

def create_external_transfer_with_aml(
    amount,
    asset_type,
    sending_vault_id,
    externalAddress,
    aml_withdrawal_purpose,
    aml_originator_type,
    aml_originator_name="",
    aml_originator_country="",
    aml_originator_street_address="",
    aml_originator_postal_code="",
    aml_originator_city="",
    aml_originator_state_province="",
    transfer_memo="",
):
    print_header("Creating external transfer...")

    # purpose
    aml_responses={"purpose": aml_withdrawal_purpose.upper()}

    # originator
    aml_responses["originatorType"] = aml_originator_type.upper()
    if aml_originator_type.upper() == "MY_CLIENT":
        aml_responses["originatorName"] = aml_originator_name
        aml_responses["originatorCountry"] = aml_originator_country
        aml_responses["originatorStreetAddress"] = aml_originator_street_address
        aml_responses["originatorPostalCode"] = aml_originator_postal_code
        aml_responses["originatorCity"] = aml_originator_city
        aml_responses["originatorStateProvince"] = aml_originator_state_province

    idempotent_id = uuid.uuid4().hex
    transfer_params = {
        "source": {"id": sending_vault_id, "type": "VAULT"},
        "destination": {"id": externalAddress, "type": "ADDRESS"},
        "assetType": asset_type,
        "amount": amount,
        "transferMemo": transfer_memo,
        "idempotentId": idempotent_id,
        "transferAmlQuestionnaire": aml_responses,
    }

​

Added Asset-Specific Parameters for Transfers

• POST /transfers: Request body now accepts assetParametersXRP (destinationTag integer, for XRP transfers), assetParametersXLM (memo string, for XLM transfers), assetParametersATOM (memo string, for ATOM transfers — now deprecated in favor of assetParametersCosmos), assetParametersCosmos (memo string, for Cosmos blockchain transfers), and assetParametersExtra (value string, for other asset transfers).

​

Improved Tax Transactions with Detailed Asset Breakdown

• GET /tax/transactions/{subaccountId}: Response now includes receivedAsset (objects with assetType, costBasis, quantity for deposits/trades), sentAsset (similar, for withdrawals/sales), and feeAsset (transaction fee detail) arrays. The existing received, sent, and fee fields remain unchanged.

​

Improved Tax Endpoint Date Formatting and Added Cost Basis Date

• GET /tax/transactions/{subaccountId}: transactionTime now uses a consistent ISO-8601 date-time format.
• GET /tax/gains/costbasis/{subaccountId}: Added a new costBasisDate field (ISO-8601 format); saleDate now uses a consistent ISO-8601 date-time format.

​

Improved Subaccount Withdrawals with Intermediary Bank Support

• POST /subaccounts/{subaccountId}/fiat/withdrawals: Request body adds financialInstitution and intermediateFinancialInstitution objects (each with nested address, name, id, and code — enum ABA, BIC, DDA); bankAccountNr and bankRoutingNr moved inside beneficiary; added accountNumber within beneficiary and country within beneficiary.address.
• GET /subaccounts/{subaccountId}/fiat/withdrawals/{transactionId}: Response customerDetails object now reflects the updated request body fields.

​

Added Gas Station Support for Atlas Settlements

• POST /atlas/settlements/{settlementId}/accept: Request body now accepts a useGasStation boolean to have Gas Station cover fees for the acceptor.
• POST /atlas/settlements: Request body now accepts a useGasStation boolean to have Gas Station cover fees for the proposer.
• GET /atlas/settlements: Response data.proposerSide now includes gasStationEnabled (boolean, nullable if the caller lacks access to this information).
• GET /atlas/settlements/{settlementId}: Response settlement.proposerSide now includes gasStationEnabled (boolean, nullable if the caller lacks access to this information).

​

Improved Subaccount Transactions with Batch Creation

• POST /subaccounts/transactions: Request body now accepts a transactions array of CreateSubaccountTransaction objects (each with sourceSubaccountId, destinationSubaccountId, assetType, amount, optional transactionMemo, and idempotentId), replacing the previous top-level fields of the same names. The 200 OK response now returns a transactionIds array of {transactionId, idempotentId} objects instead of a single transactionId.

{
  "transactions": [
    {
      "sourceSubaccountId": "ec761b5e-fd2c-497a-a9a0-f8738ac97bdf",
      "destinationSubaccountId": "3eeaf765-0df2-49c9-9e1f-db9cf3e796dd",
      "assetType": "BTC",
      "amount": "1000.00",
      "transactionMemo": "Transaction 1",
      "idempotentId": "id1"
    },
    {
      "sourceSubaccountId": "ec761b5e-fd2c-497a-a9a0-f8738ac97bdf",
      "destinationSubaccountId": "3eeaf765-0df2-49c9-9e1f-db9cf3e796dd",
      "assetType": "ETH",
      "amount": "500.00",
      "transactionMemo": "Transaction 2",
      "idempotentId": "id2"
    }
  ]
}

{
  "data": {
    "transactionIds": [
      {
        "transactionId": "c4c4652f-0c07-472c-a7f8-955fbe07775d",
        "idempotentId": "id1"
      },
      {
        "transactionId": "d5d6763e-1c18-4d4e-a4f9-966cbe18886e",
        "idempotentId": "id2"
      }
    ]
  }
}

​

Added Tax Form Endpoints for Accounts and Subaccounts

• GET /tax/clients/{affiliateId}/forms: Retrieves an affiliate’s generated tax forms.
• GET /tax/subaccounts/{subaccountId}/forms: Retrieves a subaccount’s generated tax forms.

​

Improved Tax Transaction Cost Basis Updates with Structured Lots

• PATCH /tax/transaction/{transactionId}: Request body content type changed to application/json; added optional data property containing nested assetType (string) and lots (array of objects with acquisitionDatetime, quantity, and cost).

{
  "assetType": "BTC",
  "lots": [
    {
      "acquisitionDatetime": "2024-01-15T12:00:00Z",
      "quantity": "1.0",
      "cost": "20000"
    },
    {
      "acquisitionDatetime": "2024-02-20T15:30:00Z",
      "quantity": "0.5",
      "cost": "11000"
    }
  ],
  "type": "DEPOSIT",
  "acquisitionDatetime": "2024-03-05T09:45:00Z"
}

​

Added Manual Billing Charges API for Wealth Management

• POST /subaccounts/billing/charges: Creates manual billing charges (request body includes idempotentId, interval, feeType, and charges).
• DELETE /subaccounts/billing/charges/{chargeId}: Cancels a manual billing charge by its chargeId.

​

Improved Deposit Attributions with Date Filtering and New Fields

• GET /deposit-attributions/attributions: Added attributedAtStartDateTime and attributedAtEndDateTime query parameters to filter by attribution date; response now includes blockchainTxId and assetType fields.