Skip to main content
The Finrock REST API provides programmatic access to every capability of the platform — from creating MPC wallets and broadcasting transactions to running AML checks, managing exchange accounts, and generating invoices. All requests target a single base URL, speak JSON, and require authentication on every protected endpoint.

​
Base URL

Every API request is sent to the following base URL:
Most resource endpoints are nested under the /dac/v1/ path prefix. For example, to list transactions you call GET https://api.finrock.io/dac/v1/transactions.

​
Request & Response Format

All request bodies must be serialised as JSON, and all successful responses are returned as JSON. Set the Content-Type header to application/json on every request that carries a body.

​
Authentication

All protected endpoints require two headers on every request. See the Authentication page for full setup instructions, including RSA key generation and JWT signing.
Omitting either header, or supplying an expired or malformed JWT, returns a 401 Unauthorized response. The JWT exp field must be within 30 seconds of iat or the request is rejected immediately.

​
Rate Limiting

Rate limits are enforced per API key, per minute. When your application exceeds the limit for an endpoint, the API responds with HTTP 429 Too Many Requests. The limit resets at the start of the next minute. Every response includes three rate-limit headers so your application can track usage in real time:
Rate limits are applied globally across all your API users for the same key. To request a limit increase, contact support@finrock.io.

​
HTTP Status Codes

The API uses standard HTTP status codes to indicate the outcome of every request.

​
API Resources

Wallets & Addresses

Create and manage MPC wallets, generate deposit addresses, validate addresses, and configure auto-forwarding.

Transactions

Initiate withdrawals and transfers, query transaction history, estimate fees, and track transaction status.

Gas Tanks

Fund and monitor gas tanks that automatically cover network fees for outgoing transactions on EVM and TRON networks.

Exchanges

Connect exchange accounts, retrieve balances, and execute trades directly through the API.

AML

Run anti-money-laundering checks on addresses and transactions, manage frozen addresses, and review AML status.

Invoicing

Create and retrieve payment invoices and use the hosted payment widget for seamless crypto checkout flows.

Utilities

Query supported assets, retrieve live asset prices, and access other platform utility endpoints.