A API do P2P Dash

O teu saldo no Google Sheets

Na tua folha, abre Extensões → Apps Script e cola esta função. Em Definições do projeto → Propriedades do script, adiciona P2PDASH_TOKEN com o teu token. Depois escreve a fórmula numa célula. Funciona com qualquer campo do resumo, por exemplo "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

O Sheets guarda o resultado e só volta a perguntar quando a fórmula muda. Para atualizar, junta um segundo argumento como =P2PDASH("totalBalance", A1) e altera A1. Cada célula é um pedido. Quem puder editar a folha também consegue ler o token no Apps Script, por isso não faças isto numa folha que outras pessoas editam.

Juros por mês

A série temporal com granularity=month dá-te um ponto por cada mês com dados. Instala a biblioteca uma vez com 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 por plataforma

Guarda isto como xirr.mjs e corre node xirr.mjs (Node.js 18 ou mais recente). O XIRR vem como fração: 0.0984 quer dizer 9,84% por ano. Uma plataforma sem dados suficientes recebe 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   -

Números para a declaração de impostos

Juros e bónus por plataforma para um ano, resumidos com jq. O que conta como rendimento depende das regras do teu país; a API só mostra o que está no 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
}

Listas e detalhes

GET /api/v1/account

Que token estás a usar, os seus âmbitos e quando expira. Útil para confirmar que um token ainda funciona.

GET /api/v1/platforms

Todas as tuas plataformas com os IDs, as carteiras e os totais. Começa aqui para encontrar os IDs.

GET /api/v1/platforms/{id}

Uma plataforma, o mesmo objeto que aparece na lista.

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

Quando mudaste o teu plano para uma plataforma (crescer, manter, sair, etc.).

GET /api/v1/portfolios

Todas as tuas carteiras com as respetivas plataformas.

GET /api/v1/portfolios/{id}

Uma carteira.

GET /api/v1/platform-types

Factos por tipo de plataforma: país, classes de ativos, regulação, ano de fundação. São iguais para todos os utilizadores.

Parâmetros de consulta

from, to

Só para timeseries. Dias no formato YYYY-MM-DD, ambos incluídos. Com month ou year alargam-se a períodos completos. Os saldos continuam a contar desde o teu primeiro dia com dados, por isso um from mais tarde não os põe a zero.

granularity

Só para timeseries. day (predefinição), month ou year. A data de cada ponto é o último dia do seu período. Um dia ou período sem dados não tem ponto nenhum, por isso não contes com zeros.

year

Só para tax. Um ano civil, por exemplo 2025. As plataformas sem dados nesse ano ficam de fora.

Existem mais dois códigos 403, forbidden e plan_required. Com uma conta normal não os vais ver.

Exemplo: uma data que não existe

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"
      }
    ]
  }
}