Phantom wallet API integration (Solana, Ethereum, Bitcoin, NFTs)

Multi-chain balance API

Pull SOL, SPL token, ERC-20, native ETH, MATIC, BASE, SUI and BTC balances for any Phantom address in a single call. Useful for portfolio dashboards that need a unified net-worth figure across the eight chains Phantom currently supports.

Transaction history & statement export

Paginated transaction feeds per chain with from/to filters, token filters, and CSV/JSON/XLSX export. Drop-in replacement for the manual blockchain-explorer CSVs that tax tools like Koinly, CoinLedger and Awaken currently consume from Phantom users.

NFT and Ordinals catalog

List held NFTs (Solana NFT Standard, Metaplex Core, ERC-721/1155) and Bitcoin Ordinals with collection metadata, floor-price hints and last-traded values. Powers gallery views, in-app verification and creator royalty reconciliation.

PSOL liquid staking events

Phantom rolled out PSOL, its native liquid staking token, in May 2025. We expose stake, unstake and reward events alongside Kamino lending positions opened against PSOL, so back-office systems can mark positions to market.

Swap and route reconciliation

Decode Phantom in-app swaps across Solana, Ethereum, Base and Sui, including the 0.85% aggregator fee, gas refuelling on the destination chain, and the source DEX (Jupiter, 0x, Lifi, etc.) used for each leg.

Webhook event stream

Subscribe to address-scoped events (incoming transfer, NFT mint, stake reward, swap settled). Each webhook is signed with HMAC-SHA256 and includes an idempotency key so your downstream pipeline can deduplicate retries safely.

1. Crypto tax exports for accounting platforms

Replace the manual "blockchain explorer → CSV → tax tool" flow that Phantom currently documents for tax season. Our API returns a normalised ledger across Solana, Ethereum, Base, Polygon, Sui and Bitcoin, with cost basis hints and chain-native fees, ready for ingestion by Koinly, CoinLedger or Awaken pipelines.

2. Portfolio analytics for fintech apps

Surface a unified Phantom balance view inside a neobank or robo-advisor app. We aggregate token balances, NFT mark-to-market, and PSOL staking yield, then push them into your existing OpenFinance schema next to bank and brokerage accounts.

3. Treasury and back-office reconciliation

For DAOs, on-chain funds and crypto-native companies, reconcile in-app Phantom swaps against DEX execution data. Our event stream emits both legs (input/output token, route, fee) so finance can match the user-visible swap to the on-chain settlement.

4. NFT and Ordinals marketplace dashboards

Marketplaces (Magic Eden, Tensor, OpenSea) and analytics tools can query Phantom-held collections, including Solana Metaplex assets and Bitcoin Ordinals, to power "your collection" pages, royalty enforcement, and creator payout calculations.

5. Compliance & risk scoring

Compliance teams can score Phantom addresses against sanctioned lists, mixer interactions, and FATF Travel Rule counterparties. Combined with the webhook stream, risk events can pause flows in your product before settlement.

Auth — exchange a Phantom Connect signature

POST /api/v1/phantom/auth
Content-Type: application/json

{
  "address": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
  "chain": "solana",
  "signature": "4kJp...8hQ==",
  "nonce": "b6c1e2d4"
}

200 OK
{
  "access_token": "eyJhbGciOi...",
  "expires_in": 3600,
  "scopes": ["balances:read","transactions:read","nfts:read"]
}

Read — multi-chain balance snapshot

GET /api/v1/phantom/balances?address=9xQ...Fin&chains=solana,ethereum,bitcoin
Authorization: Bearer <ACCESS_TOKEN>

200 OK
{
  "address": "9xQ...Fin",
  "balances": [
    {"chain":"solana","symbol":"SOL","amount":"42.137","usd":"6320.55"},
    {"chain":"solana","symbol":"PSOL","amount":"10.000","usd":"1502.10"},
    {"chain":"ethereum","symbol":"ETH","amount":"1.842","usd":"5821.30"},
    {"chain":"bitcoin","symbol":"BTC","amount":"0.0712","usd":"4680.20"}
  ],
  "as_of": "2026-05-01T00:00:00Z"
}

Webhook — PSOL stake event

POST https://your-app.example.com/hooks/phantom
X-OFL-Signature: sha256=2c1b...d09f
X-OFL-Idempotency: evt_01HZ4Q3W

{
  "event": "stake.completed",
  "address": "9xQ...Fin",
  "chain": "solana",
  "product": "PSOL",
  "amount_sol": "5.000",
  "psol_received": "4.978",
  "tx_hash": "5kJ...Qv9",
  "occurred_at": "2026-04-30T18:11:42Z"
}

# Verify with HMAC-SHA256(secret, body) and compare to X-OFL-Signature.
# Reject duplicate X-OFL-Idempotency values to make retries safe.

Regulatory alignment

The EU's Markets in Crypto-Assets Regulation (MiCA) applies to crypto-asset service providers from 2025, and the EU Transfer of Funds Regulation Travel Rule has been fully enforceable since 30 December 2024. Our deliverables include consent logs, originator/beneficiary fields, and policy hooks so your product can satisfy MiCA, US FinCEN AML reporting, and FATF Travel Rule expectations.

Privacy posture

Phantom is self-custodial — we do not request or store seed phrases. Integrations operate on public on-chain data plus what the user authorises through Phantom Connect. Personal data (email, IP) is collected only when a customer opts in, retention windows are configurable, and the schema follows GDPR data-minimisation patterns.

Deliverables checklist

• OpenAPI 3 specification covering balances, transactions, NFTs, staking, swaps, webhooks
• Protocol and authorisation report (Phantom Connect signature flow, RPC and indexer choices)
• Runnable source in Python and Node.js, with TypeScript types
• Automated tests, Postman collection, and a sandbox dataset
• Compliance notes for MiCA, FinCEN, FATF Travel Rule and GDPR

Engagement workflow

1. Scope confirmation: chains, data types, retention, and webhook channels.
2. Protocol analysis and API design (2 to 5 business days).
3. Build and internal validation against live Phantom addresses (3 to 8 business days).
4. Documentation, sample apps, and test cases (1 to 2 business days).
5. First delivery typically lands in 5 to 15 business days; multi-chain rollouts may take longer.

About OpenFinance Lab

We are an independent studio focused on OpenData, OpenFinance and OpenBanking integrations for mobile and Web3 apps. The team has shipped production code for fintechs, payment gateways, exchanges, and crypto analytics products, and we know the difference between a quick scrape and an integration that survives a regulator's review.

• Wallets, exchanges, custody, and on/off-ramp integrations
• Enterprise API gateways and security reviews
• Custom Python, Node.js and Go SDKs and test harnesses
• Source code delivery from $300 — runnable code plus full documentation; pay after delivery upon satisfaction
• Pay-per-call API billing — access our hosted API and pay only per call, no upfront cost

Contact

Send us your target app and concrete data needs (chains, fields, volumes, regions). We respond within one business day with scope, timeline and a quote.

Contact page