financekit

Query Apple Wallet accounts, balances, and transactions with resumable sync.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/KumarAdi8/AgentKit --skill financekit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: financekit
Source: https://github.com/KumarAdi8/AgentKit/tree/main/skills/financekit
Command: npx skills add https://github.com/KumarAdi8/AgentKit --skill financekit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

FinanceKit centralizes secure, on-device access to Apple Wallet financial data so apps can read accounts, balances, transactions, and Wallet orders without requiring server-side access or manual reconciliation.

Core Features & Use Cases

  • Account and Balance Queries: Fetch asset and liability accounts with typed balance representations and interpret credit/debit correctly per account type.
  • Transaction Access and Monitoring: Query transactions with predicates, paginate results, and use history APIs for resumable sync and incremental updates.
  • Resumable Sync & Background Delivery: Persist history tokens, handle historyTokenInvalid recovery, and configure background delivery via an extension for iOS 26+.
  • Authorization & Safety: Built-in availability checks, managed entitlement requirements, authorization flows, and FinanceError handling for restricted data scenarios.
  • Wallet Orders & Transaction Picker: Save and query Wallet orders and use a transaction picker for ephemeral, user-selected access without full authorization.

Quick Start

Fetch recent Apple Card transactions and current account balances for the past 30 days and return a resumable history token for incremental sync.

Frequently Asked Questions about financekit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I access Apple Wallet transaction history on-device in my iOS app?

Access Apple Wallet transaction history on-device by using FinanceKit to query accounts, balances, and transactions for Apple Card and Apple Cash. This allows secure financial data retrieval without requiring server-side access or manual reconciliation.

What is the best way to implement incremental sync for Apple Card transactions?

The best way to implement incremental sync for Apple Card transactions is to persist history tokens from FinanceKit. This enables resumable sync and incremental updates, allowing your app to fetch only newly recorded transactions on subsequent queries.

Can I read Apple Cash balances without requesting full financial data authorization?

You can read Apple Cash balances by completing FinanceKit authorization flows, but you can also use a transaction picker for ephemeral, user-selected access. This transaction picker grants temporary access to specific transactions without requiring full account authorization.

How do I set up background delivery for FinanceKit transaction updates on iOS?

Set up background delivery for FinanceKit transaction updates by configuring a dedicated extension for iOS 26+. This background delivery mechanism ensures your app receives incremental transaction updates and resumable syncs even when not actively running.

Why does my FinanceKit history token become invalid and how do I handle it?

A FinanceKit history token becomes invalid when the underlying financial data changes significantly. Handle this historyTokenInvalid recovery scenario by implementing FinanceError-based error handling to reset your sync state and re-query transactions from the beginning.

Do I need special entitlements to query Apple Wallet financial data in my Swift app?

Yes, you need managed entitlements to query Apple Wallet financial data in your Swift app. FinanceKit requires built-in availability checks and managed entitlement requirements before your app can execute authorization flows and access restricted financial data.