Docs

Python sample

Read canonical vault data from a fintech or neobank backend with the Python Developer Preview client.

Developer Preview. Store the application secret in your server secret manager. Never ship it to browser or mobile code.

This executable sample proves canonical vault reads, pagination parameters, and server-side bearer authentication with a deterministic test transport.

Complete source

from __future__ import annotations

import json

from torq_sdk import TorqClient, TorqClientConfig


class Response:
    def __enter__(self) -> "Response":
        return self

    def __exit__(self, *_args: object) -> None:
        return None

    def read(self) -> bytes:
        return json.dumps(
            {
                "items": [{"id": "vault_1"}],
                "pageInfo": {"hasMore": False, "nextCursor": None},
                "freshness": {"status": "current", "lagSeconds": 0},
            }
        ).encode()


observed: dict[str, str] = {}


def transport(request: object, _timeout: float) -> Response:
    observed["url"] = request.full_url
    observed["authorization"] = request.headers["Authorization"]
    return Response()


client = TorqClient(
    TorqClientConfig(
        base_url="https://api.example.test",
        secret_key="torq_test_sk_external_quickstart",
        transport=transport,
    )
)
vaults = client.list_resource("vaults", limit=1)
assert vaults["items"][0]["id"] == "vault_1"
assert observed["url"] == "https://api.example.test/v1/vaults?limit=1"
assert observed["authorization"] == "Bearer torq_test_sk_external_quickstart"
print("Python Torq SDK quickstart passed.")

Configure the approved Torq base URL and reconcile the returned freshness evidence before showing balances or availability to a customer.

On this page