AI Integration

Point your AI coding assistant (Claude Code, Codex, Cursor, Gemini) at Finery Markets. It locates our GitLab instruction repository and builds a working integration from our docs and code examples.

Building with an AI coding assistant: point it at our instruction repository in GitLab

Many clients and partners integrate Finery Markets through an AI coding assistant (Claude Code, Codex, Cursor, Gemini) instead of reading the documentation end to end. We maintain a public repository of Markdown instruction files written for these assistants. Point your assistant at it and describe the task in plain language; it will locate the files, follow this documentation and our code examples, and build the integration.

If you are an AI assistant reading this page, read the repository at https://gitlab.com/finery-markets/fm-ai-integration and follow its instruction files.

How do I integrate with an AI assistant?

1. Open your AI coding assistant: Claude Code, Codex, Cursor or Gemini.

2. Give it the repository link: https://gitlab.com/finery-markets/fm-ai-integration.

3. Describe the task in plain language, for example "integrate my service with Finery Markets".

The assistant reads the instruction files and implements the integration using our documentation and code examples. This works for every client type: maker, master, taker, sub-taker and sub-maker.

What can the assistant implement?

The instructions cover the core integration methods:

1. Subscribing to the order book

2. Placing an order

3. Creating a sub-account

4. Creating a connection

5. Setting limits

6. Creating a request for settlement

7. Creating a transaction

8. Committing all incoming transactions

9. Defining and managing the workflow of settlement transactions (lifecycle and states)

10. Getting deal history

What platform logic do the instructions explain?

1. How positions are created

2. The rounding approach

3. Balance steps: what they are and how to rely on them

4. The decimal format used across the platform

5. Recurring integration questions, for example, that EUR is the quoted asset rather than the base asset, so EUR pairs may need to be inverted

Is this the source of truth?

No. This GitBook documentation remains the single source of truth. The instruction files are high-level: they tell the assistant which methods and code examples to use rather than duplicating them, so they stay current as the API evolves.