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.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.A JSON structure sent in a request.
The platform account that is currently being accessed. A user can switch context to work across multiple tenants with a single login.
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