Overview
Cross-cutting technical topics of the V3 Custody platform: environments, amount precision, pagination, idempotency, errors, webhooks, and the access model.
The Platform section covers cross-cutting technical topics shared across the entire API: how to address your instance, how to read amounts, how to page and filter, and how to handle errors and webhooks. Both the guides and the concepts build on these topics.
Prerequisites
- Your instance's base URL, shown as
[BASE_URL]in the examples. - An access token for the
Authorizationheader (see Authentication).
What's in this section
Environments and base URLs
How to address your instance; the /api/v1 prefix.
Authentication in depth
Magic link, sessions, Bearer, and cookies.
Amounts and precision
Raw units and decimal representation.
Pagination and filters
Keyset pagination and common filters.
Idempotency
Safe retries with idempotencyKey.
Error model
Error response structure and codes.
Webhooks
Incoming Wallet Service events.
Access model
Visibility isolation and group-based permissions.
Assets and networks
The Network registry and tokens by contract address.