Install
$ agentstack add skill-skills-il-tax-and-finance-israeli-crypto-tax-reporter ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Israeli Crypto Tax Reporter
Instructions
Step 1: Understand the Israeli Crypto Tax Framework
Before performing any calculations, ensure you understand the key regulatory principles:
Core legal basis:
- Cryptocurrency is classified as an asset (neches) under Section 88 of the Income Tax Ordinance (Pekudat Mas Hachnasa), not as currency.
- Gains from selling crypto are taxed as capital gains (revach hon) under Chapter E of the Ordinance.
- The Israeli Tax Authority published Circular 2018/05 (chozar 05/2018) which provides the primary guidance on crypto taxation.
- The circular was reinforced by subsequent guidance and court rulings establishing that crypto is a taxable asset.
Tax rates:
- Individuals: 25% capital gains tax on profits. If the seller is a "significant shareholder" (baal meniayot mahuti) of a crypto project, the rate is 30%.
- Business/traders: If crypto activity constitutes a business (esek), gains are taxed as ordinary income at marginal rates (up to 47%, plus the surtax) instead of the 25% capital rate. This is the single highest-stakes determination in crypto tax. Circular 05/2018 sets out the "badge of trade" factors the assessing officer weighs - walk the user through them rather than guessing: (1) frequency and volume of trades, (2) holding period (short flips lean business), (3) time and attention devoted to trading, (4) use of leverage or sophisticated strategies, (5) the taxpayer's professional knowledge of the market, (6) financing method, and (7) whether crypto is held as inventory vs. long-term investment. No single factor decides it; the overall pattern does. When the answer is genuinely borderline, recommend a pre-ruling (hachlatat misui) or CPA review. Business classification also pulls in National Insurance + health tax (see references) and, for miners and dealers, VAT at 18% plus osek registration - which is outside this skill's scope and needs separate professional consultation.
- Companies: Standard corporate tax rate (23%, since 2018) applies to capital gains.
- Surtax (mas yesafim): the 2025 budget reform restructured the surtax from a flat 3% on labor income into a two-component charge that explicitly reaches passive and capital income, including crypto capital gains. For 2026 the structure is 3% base on all taxable income above NIS 721,560 PLUS an additional 2% on capital-source income (capital gains, dividends, interest, rentals) above the same threshold - effective 5% on crypto gains in the band above the threshold. The threshold (NIS 721,560 / monthly NIS 60,130) is frozen through tax year 2027 by the December 2024 indexation-pause amendment, so do not apply CPI uplifts. The pre-2025 framing of "3% surtax on labor income only" is obsolete; crypto capital gains are now within the surtax base, materially raising the effective rate on large realizations.
Cost basis method:
- Israel mandates FIFO (First In, First Out) for calculating cost basis unless the taxpayer can demonstrate a different method was consistently applied.
Currency conversion:
- All transactions must be converted to New Israeli Shekel (NIS) at the exchange rate on the transaction date.
- For crypto-to-crypto trades, the NIS value of both sides must be determined at the time of trade.
Step 2: Collect Transaction Data
Gather the user's complete transaction history. The following data points are needed for each transaction:
- Date and time of the transaction
- Transaction type: buy, sell, trade (crypto-to-crypto), receive (airdrop, staking reward, mining), send, gift
- Asset: Which cryptocurrency (BTC, ETH, etc.)
- Amount: Quantity of the asset
- Price in NIS (or USD/other fiat for conversion): The value at the time of transaction
- Exchange/platform: Where the transaction occurred (Bits of Gold, Binance, Coinbase, etc.)
- Fees: Transaction fees, gas fees, exchange fees (deductible from gains)
- Wallet addresses (optional, for verification)
Common data sources:
- Israeli exchanges: Bits of Gold (bits.co.il), Bit2C (bit2c.co.il) provide transaction history exports
- International exchanges: Binance, Coinbase, Kraken, KuCoin provide CSV exports
- DeFi protocols: On-chain transaction history from Etherscan, BscScan, etc.
- Hardware wallets: Ledger Live, Trezor Suite export functions
Step 3: Calculate Capital Gains Using FIFO
Use the crypto gains calculator script to process transactions:
python scripts/crypto-gains-calculator.py --input transactions.csv --year 2024 --currency ILS
The calculator applies FIFO methodology:
- Queue all purchases by date (oldest first)
- For each sale, match against the oldest available purchase lots
- Calculate gain/loss for each matched lot: (sale price - purchase price - fees) per unit
- Sum all gains and losses for the tax year
- Convert to NIS using Bank of Israel exchange rates for the transaction dates
Key FIFO rules for Israel:
- When selling a portion of holdings, the cost basis comes from the earliest (oldest) acquisition
- If a lot is partially consumed, the remainder stays in the queue
- Crypto-to-crypto trades are treated as a disposal (sale) of one asset and acquisition (purchase) of the other
- The NIS value at the time of the trade determines both the sale price and new acquisition cost
Step 4: Classify DeFi and Special Income
Different crypto activities have different tax treatments in Israel:
| Activity | Classification | Tax Rate | Reporting | |----------|---------------|----------|-----------| | Buy and hold, then sell | Capital gain | 25% | Form 1325 | | Crypto-to-crypto swap | Capital gain (disposal + acquisition) | 25% | Form 1325 | | Staking rewards | Ordinary income or capital gain (debated) | 25-50% | Form 1301 or 1325 | | Liquidity mining/yield farming | Ordinary income | Marginal rates | Form 1301 | | Airdrops (free tokens) | Income at receipt, capital gain on sale | Marginal + 25% | Form 1301 + 1325 | | Mining | Business income or capital gain | Depends on scale | Form 1301 or 1325 | | NFT sales (creator) | Business income | Marginal rates | Form 1301 | | NFT sales (collector) | Capital gain | 25% | Form 1325 | | Hard fork tokens | Zero cost basis, capital gain on sale | 25% | Form 1325 | | Lending interest (CeFi/DeFi) | Interest income | 25% (passive) | Form 1301 |
Important classification notes:
- Staking: The Tax Authority has not issued definitive guidance on staking. Conservative approach treats rewards as income at receipt (valued at market price), then capital gain/loss on subsequent sale. Some tax advisors argue it is similar to dividends (25% rate).
- Airdrops: Received tokens are considered income at the market value on the date of receipt. Cost basis for future sale is that market value.
- Hard forks: New tokens from hard forks (e.g., BCH from BTC) have a zero cost basis. The entire sale proceeds are treated as capital gain.
- DeFi yields: Liquidity provision rewards, farming rewards, and similar DeFi income are generally classified as ordinary income, taxed at marginal rates.
Consult references/crypto-tax-regulations.md for detailed regulatory analysis. Consult references/crypto-tax-scenarios.md for worked examples of each scenario.
Step 5: Generate Form 1322 / 1325 Data
Crypto capital gains for individuals are reported on Appendix ג to the annual tax return. Two related forms are involved:
- Form 1322 (Nispach Gimel) - the primary capital gains schedule attached to the annual return; this is where totals land.
- Form 1325 (Nispach Gimel(1)) - an auxiliary detail form for negotiable-securities sales where tax was not withheld at source. It feeds line totals into Form 1322. Most crypto sales (no Israeli source-withholding) belong here.
Generate the required data:
python scripts/crypto-gains-calculator.py --input transactions.csv --year 2025 --form-1325
The form requires for each disposal:
- Asset description: "Bitcoin (BTC)" or similar
- Date of acquisition: Purchase date (FIFO-determined)
- Date of disposal: Sale date
- Acquisition cost (in NIS): Original purchase price + fees
- Disposal proceeds (in NIS): Sale price - fees
- Capital gain or loss (in NIS): Proceeds minus cost
- Holding period: Records whether the lot was held under or over 12 months. For crypto, individuals pay 25% in both cases - there is no US-style long-term-rate preference. The duration matters mainly for the inflation-component (sechum hatzmada) calculation under Section 91(b)(3), which the calculator does NOT yet apply (see Gotchas).
Loss offsetting rules:
- Capital losses from crypto can offset capital gains from crypto in the same tax year
- Capital losses from crypto can offset capital gains from other assets (stocks, real estate) in the same year
- Capital losses can be carried forward to offset capital gains in future years under Section 92 of the Income Tax Ordinance (but cannot offset ordinary income)
- Losses from one spouse can offset gains of the other spouse if filing jointly
Step 6: Calculate Advance Tax Payments (Mikdamot)
If the user has crypto gains during the year, they generally need to file and pay advance tax (mikdama) ahead of the annual return:
- Form: Form 1399י (1399-yod) for individuals - the dedicated capital gains advance-payment form. Virtual-currency disposals are filed with transaction codes 77 (sale) and 71 (virtual currency). Form 1399ח is the equivalent for companies.
- Reporting deadline: within 30 days of the capital gain event for one-off disposals; the form is filed to the assessing officer (pakid shuma).
- Payment: 25% of the gain for individuals (or 30% for significant-shareholder cases).
- Annual reconciliation: advance payments are credited against the final annual tax liability when filing the annual return.
- Penalties for non-payment: interest (ribit) and linkage differences (hafreshei hatzmada) accrue from the 30-day deadline.
The legacy "Form 7002" reference in older guides is outdated for crypto reporting - use Form 1399י.
python scripts/crypto-gains-calculator.py --input transactions.csv --year 2025 --advance-payments
Step 7: Provide Filing Guidance
Guide the user through the tax filing process:
- Compile capital gains schedule: list all disposals on Form 1325 (auxiliary), with totals carried into Form 1322 (Appendix ג of the annual return).
- File annual tax return: submit Form 1301 (the individual annual return, doch shnati) with Forms 1322 and 1325 attached as appendices. A crypto disposal generally creates a filing obligation, but check the TY2025 exemption first: a draft amendment to the exemption-from-filing regulations (טיוטת תקנות מס הכנסה (פטור מהגשת דין וחשבון), published for comment Jan 2025) exempts a salaried taxpayer from the annual return on crypto gains when the crypto was traded through a supervised Israeli platform that withheld the tax at source AND total income stays under the Section 131 ceilings (roughly NIS 723,000 gross from work/business, or NIS 721,560 total taxable income from all sources). Exceeding either ceiling, incomplete withholding, or trading through an unsupervised/foreign venue restores the full Section 131 filing duty. Paying an advance (mikdama) does NOT by itself remove the annual-return obligation. Verify the final regulation text before relying on the exemption, since it was still in draft as of mid-2026.
- Filing deadline: for tax year 2025 (filed in 2026), the deadlines published by the Israeli Tax Authority are 30 June 2026 for online filing via the gov.il portal and 29 May 2026 for paper filing. Returns filed via a representing accountant typically receive extensions through July or September. Always verify the current year's deadlines on gov.il/he/service before filing.
- Self-assessment of surtax: individuals whose total taxable income (including crypto gains) exceeds NIS 721,560 must also self-assess surtax (mas yesafim) - 3% base on income above the threshold plus an additional 2% on capital-source income above the same threshold. The threshold is frozen through 2027.
- Voluntary Disclosure window: prior-year unreported crypto gains can be regularised under the 2025-2026 Voluntary Disclosure Procedure (Nohal Gilui Mirtzon), which expressly covers digital assets and grants criminal immunity. Deadline: 31 August 2026. Two tracks: a Green Track for smaller cases (annual income up to NIS 500k and cumulative crypto assets up to NIS 1.5M as of 31 Dec 2024) and a Regular Track for larger cases. Anonymity is no longer available; all applications are filed with identifying details.
- Paying tax when a bank refuses the funds (Form 909): a recurring Israeli pain point is that a commercial bank refuses (in writing) to accept crypto-derived deposits, leaving the taxpayer unable to fund the tax payment from a normal account. For this case the ITA, with the Bank of Israel and the Anti-Money-Laundering Authority, runs a special procedure (Hora'at Sha'a, ITA Instruction 06/2024) under which an individual (not a company) files Form 909 ("דיווח על פעילות במטבעות וירטואליים ובקשה לתשלום המס המגיע במימוש המטבעות") to the assessing officer and pays the tax in NIS directly into the ITA's account at the Bank of Israel. Required attachments include a written bank-refusal letter, a taxable-income working paper, a full money-trail of the coins, and proof of the legal source of the original funds. Filed online via the ITA CRM together with the annual return, or physically at the assessing officer. The request undergoes a money-laundering-risk review before payment is accepted.
- Record keeping: maintain all transaction records, exchange exports, and wallet data for at least 7 years.
When to recommend professional help:
- Transaction volume exceeds 100 trades per year
- DeFi activities involve complex protocols (multi-chain, bridging, wrapping)
- User is unsure whether activity constitutes a business vs. investment
- Total gains exceed 500,000 NIS
- User received tokens from an ICO, IEO, or similar offering
- Cross-border transactions involving Israeli and foreign tax obligations
Examples
Example 1: Simple Bitcoin Buy and Sell
User says: "I bought 0.5 BTC in January 2025 for 80,000 NIS and sold it in August 2025 for 120,000 NIS. What's my tax?"
Actions:
- Identify the transaction: single buy, single sell.
- Calculate capital gain: 120,000 - 80,000 = 40,000 NIS.
- Apply 25% capital gains tax: 40,000 x 0.25 = 10,000 NIS.
- Check surtax threshold: a 40,000 NIS gain is well below NIS 721,560, so no surtax (assuming no other income above the threshold).
- Note the holding period: 7 months. The 25% rate applies regardless, but the inflation-component split (sechum hatzmada) is negligible for such a short hold.
Result: capital gain 40,000 NIS, tax liability 10,000 NIS. The user should have filed Form 1399י (transaction codes 77/71) within 30 days of the August sale and paid the 10,000 NIS as a mikdama. If the deadline is missed, the user should still file and pay as soon as possible to minimise interest and linkage penalties. The gain is then reported on Forms 1325/1322 as part of the 2025 annual tax return, due 30 June 2026 (online) or 29 May 2026 (paper).
Example 2: Crypto-to-Crypto Trade with FIFO
User says: "I bought 2 ETH at 5,000 NIS each in March 2024, then 3 ETH at 7,000 NIS each in June 2024. In October I traded 3 ETH for 0.5 BTC when ETH was worth 9,000 NIS each. What's my tax situation?"
Actions:
- Build the FIFO queue: Lot 1: 2 ETH @ 5,000 NIS (March), Lot 2: 3 ETH @ 7,000 NIS (June)
- Process the disposal: 3 ETH traded in October (crypto-to-crypto = taxable disposal)
- Apply FIFO: First consume Lot 1 (2 ETH @ 5,0
…
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: skills-il
- Source: skills-il/tax-and-finance
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.