getneo
    getneo
    • Introduction
    • API examples
    • Technical topics
      • API structure
      • HTTP headers
      • Decoupled responses
      • Validation failures (418)
    • Endpoints
      • Auth
        • Get service bearer token (password)
          GET
        • Change tenant
          GET
        • End session
          GET
      • Counterparties
        • Get all counterparties
          GET
        • Get counterparty by ID
          GET
        • Get draft counterparty by ID
          GET
        • Submit counterparty draft
          POST
        • Update counterparty draft
          POST
        • Delete a counterparty draft
          DELETE
        • Add account to counterparty
          POST
        • Update counterparty account
          PATCH
        • Export counterparty data
          POST
      • Payments
        • Get all payments
          GET
        • Get a payment by ID
          GET
        • Make a payment (deposit, withdrawal or internal)
          POST

    Introduction

    Important
    This documentation is incomplete and is subject to change.
    This is the technical documentation for using the API of the getneo platform ("Neo").
    Not all APIs are available to every client, based on factors such as contract type. If you wish access to an API that doesn't work for you (most likely responding with a 403 Forbidden status), please contact us to discuss.
    If you have specific questions about any of the content or some missing information, please contact support@getneo.com with your questions.

    Design#

    The platform is provided as a set of HTTP web services, designed using RESTful concepts, with minor customisation to typical flow in order to facilitate better and more secure workflows.
    Due to the structured nature of the data, the API always responds in JSON format unless stated otherwise. Equally, all request bodies are preferred in JSON format, although other standards (i.e., x-www-form-urlencoded) will be accepted, but support is not guaranteed.
    The modifications that are applied throughout the whole platform are described in this documentation.

    Environments#

    Neo provides a Demo and a Production environment.
    This documentation shows both possible URLs, but only the Demo environment can be tested here due to CORS protection.

    Services#

    The platform uses different subdomains for managing different data purposes; this documentation will specify the subdomain for each API call.
    Examples:
    auth - Authentication and security
    client - Management and information of tenant
    data - Access to reference and market data
    trade - Trade-related functionality (including quoting and payments)
    If the documentation refers to GET (auth)/api/v1/auth/login, the full URL will be https://auth.getneo.com/api/v1/auth/login.

    Terminology#

    Some Neo-specific terms used throughout the documentation have important meaning.
    Form
    A JSON structure sent in a request.
    Tenant
    The platform account that is currently being accessed. A user can switch context to work across multiple tenants with a single login.
    User
    The currently authenticated user of the platform.

    Entity Ids#

    Every entity in Neo has a unique identifier in the form of a 22-character alpha-numeric string, which will be referred to as "ids" in this documentation.
    Example: PJktaIp1jUiGODbklWBIrA
    Modified at 2025-07-01 14:59:36
    Next
    API examples
    Built with