Welcome to Zodia API Documentation.

Build secure custody and settlement workflows with signed API requests, maker-checker approvals, and institution-ready operational guides.

Get Started What’s New Explore API Reference

Quick Start

Follow the core setup path from onboarding and credentials to authentication and your first signed request.

Review the platform basics

Start with Introduction and Working with APIs to understand the custody workflow, TLS requirements, and maker-checker model.

Generate and register your credentials

Create your company RSA keys and API user ECC keys before calling the API.

Sign your first request

Use the authentication guides to create the request signature and submit a signed API call.

curl --request POST 'https://hostname.zodia.io/v3/api/servicedesk/products' \
--header 'company-identifier: YOUR_COMPANY' \
--header 'submitter-id: api-maker@your-company.com' \
--header 'request-identifier: UUID' \
--header 'request-timestamp: EPOCH_MS' \
--header 'Content-Type: application/json' \
--header 'signature: BASE64_SIGNATURE' \
--data-raw '{"productIds":["0x0013"]}'

Continue with Authentication and Signing Requests for the complete signing rules and payload examples.

Start with a guided workflow

Pick a full guide to move from setup into real operational flows:

API Reference

Explore the documentation by topic, from onboarding and authentication through service workflows, settlements, and operational references.

Working with APIs

Learn the platform basics, prerequisites, rate limits, pagination, and shared error models.

Authentication

Understand signed headers, company signatures, and maker or authoriser payload signing.

Service Desk Guide

Follow end-to-end workflows for wallets, beneficiaries, whitelisting, and outbound transfers.

Interchange Guide

Review approval modes and setup flows for clients and trading venues.

Webhooks

Configure REST or JMS notifications for wallet, beneficiary, and transfer lifecycle events.

Status Reference

Map request, wallet, transfer, and interchange settlement statuses to human-readable meanings.

Resources

Reach the team, follow company updates, and jump into the most commonly used supporting pages.

FAQs

Review common implementation questions around pagination, signatures, beneficiaries, and wallet workflows.

Support

Reach the Zodia team for onboarding help, integration questions, and operational support.

Community

Stay connected with company news, product updates, and broader digital asset custody announcements.

AI Resources

A collection of AI prompts to help get the most from this documentation and our services.

Ready to build?

Start with the onboarding and authentication guides, then move into the service desk workflows that match your integration path.

Start the Quick Start Go to Authentication