Fyrir forritara

    Sláðu inn að minnsta kosti tvo stafi.

    Fá API lykil

    Hugtök

    Síðuskipting

    Listar skila einni síðu af niðurstöðum og ógegnsæjum bendli á þá næstu. Fylgdu next_cursor þar til hann er null.

    Listar

    GET/v1/trades, GET/v1/transactions og GET/v1/giftcards skila nýjustu færslunum fyrst, einni síðu í einu:

    Síða
    {
  "data": [{ "id": "tr_01JB8X2Q4M7Z3V9K5T1N6R0P2W", "…": "…" }],
  "next_cursor": "eyJpZCI6IjY3MjdhMWMzIn0"
}
    FæribreytaMerking
    limitStærð síðu, 1 til 100. Sjálfgefið er 50.
    cursornext_cursor fyrri síðu. Slepptu henni fyrir fyrstu síðuna.
    fromAðeins færslur á þessum tíma eða síðar (ISO 8601, Z eða tímabelti).
    toAðeins færslur á þessum tíma eða fyrr. Mest 366 dögum á eftir from.

    Hver listi hefur líka sínar eigin síur, svo sem asset, side, type eða status; sjá API lýsinguna. Óþekktum færibreytum er hafnað með 400 invalid_request.

    Að fylgja bendlinum

    • next_cursor er null á síðustu síðunni.
    • Bendillinn er ógegnsær. Ekki búa hann til eða breyta honum; sendu hann til baka eins og hann er.
    • Notaðu sömu síur á allar síður sama lista.

    listAll í SDK-unum (list_all í Python) fylgir bendlinum fyrir þig:

    for await (const trade of client.trades.listAll({ asset: "BTC" })) {
  console.log(trade.created_at, trade.side, trade.base_amount);
}
    for trade in client.trades.list_all(asset="BTC"):
    print(trade["created_at"], trade["side"], trade["base_amount"])

    Eða eina síðu í einu:

    let cursor: string | undefined;
do {
  const page = await client.transactions.list({ limit: 100, cursor });
  for (const entry of page.data) console.log(entry.id, entry.label);
  cursor = page.next_cursor ?? undefined;
} while (cursor);
    cursor = None
while True:
    page = client.transactions.list(limit=100, cursor=cursor)
    for entry in page["data"]:
        print(entry["id"], entry["label"])
    cursor = page["next_cursor"]
    if cursor is None:
        break

    Tímabil

    from og to ná mest yfir 366 daga í hverri beiðni, og from má ekki vera á eftir to. Fyrir lengri sögu skaltu biðja um eitt ár í einu. Í Python er from frátekið orð, svo SDK-ið tekur við því sem from_: client.trades.list(from_="2026-01-01T00:00:00Z").