General - Finrock

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

https://api.finrock.io

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.

Content-Type: application/json

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:

Header	Type	Description
`x-rate-limit-remaining`	integer	Calls remaining for this endpoint in the current window
`x-rate-limit-limit`	string	The window size for this endpoint (e.g. `1m`)
`x-rate-limit-reset`	string	ISO 8601 timestamp when the limit window resets

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.

Status	Meaning	When it occurs
`200`	Success	The operation completed successfully
`400`	Bad Request	The request body does not match the expected schema
`401`	Unauthorized	Authentication failed — invalid, missing, or expired token
`403`	Forbidden	Authenticated but not authorised to access the resource
`404`	Not Found	The requested path or resource does not exist
`429`	Too Many Requests	Rate limit exceeded; retry after the reset timestamp
`500`	Internal Server Error	Unexpected server-side error; retry after a short delay

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.