P2P Dashi API

Sinu saldo Google Sheetsis

Ava oma tabelis Extensions → Apps Script ja kleebi sinna see funktsioon. Lisa Project settings → Script properties alla P2PDASH_TOKEN oma tokeniga. Siis kirjuta valem lahtrisse. Sobib iga kokkuvõtte väli, näiteks "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 jätab tulemuse meelde ja küsib uuesti alles siis, kui valem muutub. Värskendamiseks lisa teine argument, näiteks =P2PDASH("totalBalance", A1), ja muuda A1. Iga lahter on üks päring. Igaüks, kes saab tabelit muuta, näeb Apps Scriptis ka tokenit, nii et ära tee seda tabelis, mida teised muuta saavad.

Intress kuude kaupa

Aegrida parameetriga granularity=month annab ühe punkti iga kuu kohta, millel on andmeid. Paigalda teek üks kord käsuga 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 iga platvormi kohta

Salvesta see failina xirr.mjs ja käivita node xirr.mjs (Node.js 18 või uuem). XIRR tuleb murdarvuna: 0.0984 tähendab 9,84% aastas. Platvorm, millel pole piisavalt andmeid, saab väärtuse 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   -

Numbrid maksudeklaratsiooniks

Intress ja boonused platvormi kaupa ühe aasta kohta, jq abil lühendatud. Milline neist läheb tuluna arvesse, sõltub sinu riigi reeglitest. API näitab ainult seda, mis on P2P Dashis.

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
}

Nimekirjad ja üksikasjad

GET /api/v1/account

Millist tokenit sa kasutad, millised õigused sellel on ja millal see aegub. Mugav, et kontrollida, kas token veel töötab.

GET /api/v1/platforms

Kõik sinu platvormid koos ID-de, portfellide ja kogusummadega. Alusta siit, et ID-d üles leida.

GET /api/v1/platforms/{id}

Üks platvorm, sama objekt nagu nimekirjas.

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

Millal sa muutsid oma plaani mõne platvormi jaoks (kasvatada, hoida, väljuda jne).

GET /api/v1/portfolios

Kõik sinu portfellid koos nende platvormidega.

GET /api/v1/portfolios/{id}

Üks portfell.

GET /api/v1/platform-types

Faktid iga platvormitüübi kohta: riik, varaklassid, regulatsioon, asutamisaasta. Kõigile kasutajatele samad.

Päringu parameetrid

from, to

Ainult timeseries jaoks. Päevad kujul YYYY-MM-DD, mõlemad kaasa arvatud. Väärtusega month või year laienevad need tervete perioodideni. Saldod arvestatakse ikka sinu esimesest andmetega päevast, nii et hilisem from neid nullist ei alusta.

granularity

Ainult timeseries jaoks. day (vaikimisi), month või year. Punkti kuupäev on tema perioodi viimane päev. Päeval või perioodil ilma andmeteta pole üldse punkti, nii et nulle ära oota.

year

Ainult tax jaoks. Kalendriaasta, näiteks 2025. Platvormid, millel selles aastas andmeid pole, jäetakse välja.

On veel kaks 403 koodi, forbidden ja plan_required. Tavalise kontoga sa neid ei näe.

Näide: kuupäev, mida pole olemas

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