L'API di P2P Dash

Il tuo saldo in Google Sheets

Nel tuo foglio apri Estensioni → Apps Script e incolla questa funzione. In Impostazioni progetto → Proprietà script aggiungi P2PDASH_TOKEN con il tuo token. Poi scrivi la formula in una cella. Funziona con qualsiasi campo del riepilogo, per esempio "netIncome".

function P2PDASH(field) {
  const token = PropertiesService.getScriptProperties()
    .getProperty("P2PDASH_TOKEN");
  const res = UrlFetchApp.fetch(
    "https://app.p2pdash.com/api/v1/account/summary",
    { headers: { Authorization: "Bearer " + token } },
  );
  return JSON.parse(res.getContentText()).data[field];
}

=P2PDASH("totalBalance")   →  12233.5

Sheets tiene il risultato e richiede i dati solo quando cambia la formula. Per aggiornare, aggiungi un secondo argomento come =P2PDASH("totalBalance", A1) e cambia A1. Ogni cella è una richiesta. Chi può modificare il foglio può anche leggere il token in Apps Script, quindi non farlo in un foglio che altri possono modificare.

Interessi al mese

La serie temporale con granularity=month ti dà un punto per ogni mese con dati. Installa la libreria una volta con pip install requests.

import os
import requests

res = requests.get(
    "https://app.p2pdash.com/api/v1/account/timeseries",
    params={"granularity": "month", "from": "2026-08-01", "to": "2026-10-31"},
    headers={"Authorization": f"Bearer {os.environ['P2PDASH_TOKEN']}"},
)
res.raise_for_status()

for point in res.json()["data"]:
    print(point["date"][:7], f"{point['interest']:.2f}")

2026-08 94.80
2026-09 96.42
2026-10 98.15

XIRR per piattaforma

Salva il codice come xirr.mjs ed esegui node xirr.mjs (Node.js 18 o successivo). Lo XIRR arriva come frazione: 0.0984 vuol dire 9,84% all'anno. Una piattaforma senza abbastanza dati riceve null.

const res = await fetch("https://app.p2pdash.com/api/v1/account/metrics", {
  headers: { Authorization: `Bearer ${process.env.P2PDASH_TOKEN}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data } = await res.json();

for (const p of data.xirr.platforms) {
  const xirr = p.allTimeXirr === null
    ? "-"
    : (p.allTimeXirr * 100).toFixed(2) + "%";
  console.log(p.name.padEnd(12), xirr);
}

Platform A   9.84%
Platform B   10.37%
Platform C   11.20%
Platform D   -

I numeri per la dichiarazione dei redditi

Interessi e bonus per piattaforma in un anno, accorciati con jq. Cosa conta come reddito dipende dalle regole del tuo paese; l'API mostra solo quello che c'è in P2P Dash.

curl -s "https://app.p2pdash.com/api/v1/account/tax?year=2025" \
  -H "Authorization: Bearer $P2PDASH_TOKEN" \
  | jq '.data[] | {name, interest: .years[0].interest, bonus: .years[0].bonus}'

{
  "name": "Platform A",
  "interest": 412.37,
  "bonus": 25
}
{
  "name": "Platform B",
  "interest": 288.9,
  "bonus": 0
}

Elenchi e dettagli

GET /api/v1/account

Quale token stai usando, i suoi ambiti e quando scade. Utile per controllare che un token funzioni ancora.

GET /api/v1/platforms

Tutte le tue piattaforme con ID, portafogli e totali. Parti da qui per trovare gli ID.

GET /api/v1/platforms/{id}

Una piattaforma, lo stesso oggetto dell'elenco.

GET /api/v1/platforms/{id}/intent-history

Quando hai cambiato i tuoi piani per una piattaforma (aumentare, mantenere, uscire e così via).

GET /api/v1/portfolios

Tutti i tuoi portafogli con le loro piattaforme.

GET /api/v1/portfolios/{id}

Un portafoglio.

GET /api/v1/platform-types

Dati per tipo di piattaforma: paese, classi di attivi, regolamentazione, anno di fondazione. Uguali per tutti gli utenti.

Parametri di query

from, to

Solo per timeseries. Giorni nel formato YYYY-MM-DD, estremi inclusi. Con month o year si allargano ai periodi interi. I saldi contano comunque dal tuo primo giorno di dati, quindi un from più tardo non li azzera.

granularity

Solo per timeseries. day (predefinito), month o year. La data di un punto è l'ultimo giorno del suo periodo. Un giorno o un periodo senza dati non ha nessun punto, quindi non aspettarti degli zeri.

year

Solo per tax. Un anno solare come 2025. Le piattaforme senza dati in quell'anno non compaiono.

Esistono altri due codici 403, forbidden e plan_required. Con un account normale non li vedrai.

Esempio: una data che non esiste

curl "https://app.p2pdash.com/api/v1/account/timeseries?from=2025-02-30" \
  -H "Authorization: Bearer $P2PDASH_TOKEN"

{
  "error": {
    "code": "invalid_request",
    "message": "Not a valid calendar date",
    "details": [
      {
        "field": "from",
        "message": "Not a valid calendar date"
      }
    ]
  }
}