israeli-crypto-tax-reporter
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 50%). The classification depends on frequency, volume, and whether the taxpayer holds crypto as inventory vs. investment.
- 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. Salaried individuals with crypto income must file even if they would otherwise be exempt - any disposal generally triggers a filing obligation.
- 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.
- 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,000), then 1 ETH from Lot 2 (@ 7,000)
- Calculate gains:
- Lot 1: 2 ETH x (9,000 - 5,000) = 8,000 NIS gain
- Lot 2 partial: 1 ETH x (9,000 - 7,000) = 2,000 NIS gain
- Total gain: 10,000 NIS
- Tax at 25%: 10,000 x 0.25 = 2,500 NIS
- Note remaining position: 2 ETH from Lot 2 (@ 7,000 NIS cost) + 0.5 BTC (@ 27,000 NIS total cost, which is 3 x 9,000 NIS)
Result: The crypto-to-crypto trade triggers a taxable event of 10,000 NIS capital gain (2,500 NIS tax). The new BTC position has a cost basis of 27,000 NIS (the NIS value of 3 ETH at the time of trade). The remaining 2 ETH retain their original cost basis of 7,000 NIS each. The agent generates a Form 1325 entry for this disposal.
Example 3: DeFi Staking Rewards Classification
User says: "I staked 10 ETH on a DeFi protocol and earned 0.5 ETH in staking rewards over 2024. The ETH was worth 8,000 NIS when I received the rewards. I haven't sold anything yet. Do I owe taxes?"
Actions:
- Classify the staking rewards: under conservative interpretation, treated as income at receipt
- Calculate income: 0.5 ETH x 8,000 NIS = 4,000 NIS taxable income
- Determine the applicable rate: this could be 25% (if treated as passive income/interest) or marginal rate (if treated as ordinary income)
- Consult
references/crypto-tax-regulations.mdfor the latest guidance on staking classification - Note: the 10 staked ETH have not been disposed of, so no capital gain event on those
- Establish cost basis for the 0.5 reward ETH: 8,000 NIS per ETH (4,000 NIS total)
Result: Under the conservative approach recommended by most Israeli tax advisors, the 0.5 ETH staking reward is taxable income of 4,000 NIS in the year received, regardless of whether it was sold. The tax rate depends on classification: 25% if treated as passive income (1,000 NIS tax), or marginal rates if treated as ordinary income (potentially up to 50%). The agent recommends consulting a tax advisor for classification, as the Tax Authority has not issued definitive guidance. The 0.5 ETH has a cost basis of 4,000 NIS for future capital gains calculation.
Bundled Resources
Scripts
scripts/crypto-gains-calculator.py-- FIFO capital gains calculator with NIS conversion, supporting multiple exchanges and generating Form 1325 data. Run:python scripts/crypto-gains-calculator.py --help
References
references/crypto-tax-regulations.md-- Israeli Tax Authority circulars, relevant Income Tax Ordinance sections, classification rules for different crypto activities, and reporting deadlines. Consult when determining the correct tax treatment for specific crypto activities.references/crypto-tax-scenarios.md-- Worked examples covering simple trades, crypto-to-crypto swaps, DeFi staking, NFT sales, mining income, airdrops, and hard forks. Consult when calculating tax for specific transaction types.
Recommended MCP Servers
| MCP | What It Adds |
|---|---|
| BOI Exchange Rates | Provides the official Bank of Israel daily representative rate (sha'ar yatzig) for USD, EUR, and 30+ other currencies - the rate this skill requires for converting non-NIS legs of every transaction. Live access removes the need to scrape boi.org.il manually and ensures the FIFO calculator sees authoritative same-day NIS values. |
Gotchas
- Israel taxes crypto as property (capital gains), not as currency. Agents may apply currency-exchange rules or VAT to crypto transactions, which is incorrect under Israeli tax law.
- The Israeli capital gains tax rate on crypto is 25% for individuals (mas revach hon), not the US 15%/20% rates. Agents trained on US tax data will use the wrong rate.
- Israeli crypto tax reporting uses FIFO (First In, First Out) as the default cost basis method. Agents may default to average cost or LIFO, which are not standard practice in Israel.
- Crypto-to-crypto swaps are taxable events in Israel. Agents may treat them as non-taxable exchanges (the old US rule), but this has never been the case in Israel.
- Stablecoins (USDT, USDC, DAI) are still "asset" under Section 88 of the Income Tax Ordinance, not foreign currency. Every USDT-to-USDC swap, every conversion-leg of a DeFi trade, and every USDT off-ramp to fiat is a taxable disposal valued in NIS. Users frequently treat stablecoins as "cash equivalents" and skip them, missing the majority of taxable events for active DeFi participants.
- Inflation indexation (sechum hatzmada) is not yet applied by the calculator. Section 91(b)(3) splits any capital gain into a "real gain" (taxed at 25%) and an "inflation-component gain" (taxed at 0% for individuals on assets acquired after 1.1.1994). The current calculator multiplies total gain by 25% with no CPI step, so it overstates tax on lots held longer than ~12 months in inflationary years. For long-held lots, agents should flag this limitation to the user and recommend a manual indexation pass or a CPA review before filing.
- Israel has no wash-sale rule. Unlike the US 30-day rule, Israeli tax law allows a taxpayer to realise a December capital loss and re-buy the same crypto in January with the loss fully recognised. Agents trained on US tools may incorrectly disallow such losses.
- Gifts and inheritance use carryover basis under Section 97(a)(5) - the recipient inherits the donor's original cost basis and acquisition date. Treating an inherited 1 BTC as zero-basis or as fair-market-value at inheritance produces wildly wrong numbers. Document the donor's records.
- Crypto lost to exchange insolvency (FTX, Celsius pattern), theft, or lost private keys is recognised as a capital loss only when the loss is final and documented (e.g., bankruptcy court order, police report). Agents should not write off frozen-but-not-bankrupt balances and should not treat loss-of-keys as deductible without supporting evidence.
Troubleshooting
Error: "Cannot determine NIS exchange rate for date"
Cause: The calculator could not find the NIS/USD or NIS/crypto exchange rate for the specified transaction date. This often happens with weekends or Israeli holidays when the Bank of Israel does not publish rates.
Solution: For dates when the Bank of Israel does not publish rates (Shabbat, holidays), use the rate from the most recent business day prior to the transaction. The calculator attempts this automatically, but if it fails, specify the rate manually with the --manual-rate flag. For crypto-to-NIS conversion, the calculator uses the exchange's reported NIS price when available, or the USD price multiplied by the USD/NIS rate from Bank of Israel.
Error: "FIFO queue exhausted - more sold than purchased"
Cause: The transaction history shows more crypto being sold than was purchased. This usually indicates missing purchase transactions (e.g., deposits from another exchange, transfers from a personal wallet, or an incomplete transaction history export). Solution: Review the transaction history for completeness. Check if crypto was transferred in from another exchange or wallet (these transfers are not taxable events but must be recorded to maintain accurate cost basis). Add the missing purchase records. If the original purchase records are unavailable, Israeli tax law allows using the earliest available market price as a fallback cost basis, but this should be documented and disclosed.
Error: "Transaction type not recognized for tax classification"
Cause: The calculator encountered a transaction type it cannot automatically classify for tax purposes (e.g., a complex DeFi interaction, bridge transaction, or wrapped token conversion).
Solution: Review the transaction manually. Common DeFi operations and their classifications: wrapping (ETH to WETH) is generally not a taxable event; bridging between chains may be a taxable event if it involves a swap; providing liquidity is not taxable until withdrawal (but LP token movements may trigger events). For complex DeFi operations, consult references/crypto-tax-scenarios.md and consider professional tax advice.
Error: "Form 1325 generation failed - missing required fields"
Cause: Some transactions are missing data required for Form 1325 (typically the acquisition date or the NIS value at acquisition). Solution: Review the error output which lists the specific transactions with missing data. For each, provide the acquisition date (FIFO-determined) and the NIS value at that date. If the acquisition was a gift or airdrop, the cost basis rules differ: gifts use the donor's cost basis (Section 97(a)(5) carryover), and airdrops use the market value at receipt. Update the transaction CSV with the corrected data and re-run.
Reference Links
| Source | URL | What to Check |
|---|---|---|
| Israeli Tax Authority - annual return service (Form 1301) | https://www.gov.il/he/service/reporting-and-payment-2025-annual-tax-report-for-individuals | Current-year filing deadlines, links to Forms 1322 and 1325, online filing portal |
| Bank of Israel - representative rates (sha'ar yatzig) | https://www.boi.org.il/roles/markets/exchangerates/ | Daily NIS reference rates for currency conversion of foreign-fiat legs of crypto trades |
| ITA Circular 05/2018 (crypto classification, FIFO, virtual currency definition) | https://www.gov.il/he/Departments/legalInfo/04-2018 | Foundational tax-treatment guidance for virtual currencies |
| Voluntary Disclosure Procedure 2025-2026 (crypto track) | https://www.gov.il/he/Departments/policies/voluntary-disclosure-2025 | Eligibility, Green vs Regular Track, deadline 31 Aug 2026, required documentation |
| Bituach Leumi self-employed rates (2026) | https://www.btl.gov.il/Insurance/National%20Insurance/type_list/Self_Employed/Pages/rates.aspx | Current National Insurance + health-tax rates for business-classified crypto traders |
| OECD Crypto-Asset Reporting Framework (CARF) | https://www.oecd.org/tax/exchange-of-tax-information/crypto-asset-reporting-framework.htm | Israel collection from 1 Jan 2026, first international exchange Sept 2027 |
More from skills-il/tax-and-finance
shekel-currency-converter
Convert currencies to/from Israeli New Shekel (NIS/ILS) using Bank of Israel official exchange rates. Use when user asks to convert shekels, NIS, ILS, asks about exchange rates, "shaar yatzig" (representative rate), or needs currency conversion for Israeli tax or business purposes. Supports 30+ currencies with current and historical rates. Do NOT use for cryptocurrency or unofficial money exchange rates.
15israeli-arnona-optimizer
Calculate municipal property tax (arnona) for Israeli properties, check discount eligibility, and draft appeal letters to arnona committees. Use when a user needs to estimate arnona payments by municipality, zone, and property usage type, verify eligibility for discounts (olim, soldiers, elderly, disabled, low income, students, single parents), or prepare formal appeals with legal references. Covers all major Israeli municipalities including Tel Aviv, Jerusalem, Haifa, and Beer Sheva. Do NOT use for income tax (mas hachnasa), VAT (maam), or national insurance (bituach leumi) calculations, which fall under separate Israeli tax authorities.
14israeli-e-invoice
Generate, validate, and manage Israeli e-invoices (hashbonit electronit) per Tax Authority (SHAAM) standards. Use when user asks to create Israeli invoices, request allocation numbers, validate invoice compliance, or asks about "hashbonit", "e-invoice", "SHAAM", "allocation number", or Israeli invoicing requirements. Supports tax invoice (300), tax invoice/receipt (305), credit invoice (310), receipt (320), and proforma (330) types. Do NOT use for general accounting, bookkeeping, or non-Israeli invoice formats.
14green-invoice
Integrate Green Invoice (Morning) API for Israeli invoicing, receipts, client management, and payment processing. Use when user asks to create invoices via Green Invoice, generate hashbonit mas through Morning API, manage clients in Green Invoice, set up webhook automation for document creation, query documents or expenses, or mentions "Green Invoice", "Morning", "hashbonit yeruka", "greeninvoice API", Israeli cloud invoicing, or needs to create tax invoice-receipt (cheshbonit mas/kabala). Covers all 13 document types, 8 payment types, client CRUD, item catalog, and webhook integration. Do NOT use for SHAAM allocation numbers or Tax Authority e-invoice compliance (use israeli-e-invoice), Cardcom payment processing (use cardcom-payment-gateway), or Tranzila integration (use tranzila-payment-gateway).
13israeli-pension-advisor
Navigate the Israeli pension and savings system including pension funds (keren pensia), manager's insurance (bituach menahalim), training funds (keren hishtalmut), and retirement planning. Use when user asks about Israeli pension, \"pensia\", \"keren hishtalmut\", retirement savings, \"bituach menahalim\", pension contributions, or tax benefits from savings. Uninformed pension decisions cost hundreds of thousands of NIS over a lifetime. Covers mandatory pension, voluntary savings, and withdrawal rules. Do NOT provide specific investment recommendations or fund performance comparisons.
13israeli-payment-orchestrator
Orchestrate Israeli payment gateways (Cardcom, Tranzila, PayMe, Meshulam, iCredit, Pelecard) with unified routing, fallback, and installments (tashlumim). Use when user asks about multi-gateway payment integration, "slikat kartisim", "tashlumim", payment routing, Shva network, BOI Directive 357, gateway comparison, or building a payment abstraction layer for Israeli merchants. Provides unified API patterns, installment handling, Shva clearing rules, and regulatory compliance. Do NOT use for single gateway setup (use cardcom-payment-gateway or tranzila-payment-gateway instead).
13