Skip to content
Multi-protocol, machine-readable specifications for financial services
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

The FinSpec Specification

Welcome to the FinSpec Project!

The goal of FinSpec is to define a standard, protocol-agnostic, machine-readable specification to describe and document pre- and post-trade interfaces and workflows in financial services including (but not limited to) order entry, execution, market data, allocations and settlement.

Our hope is that the specification will allow both humans and computers to discover and understand the capabilities of an interface without needing to read through lengthy PDF documentation. As well as creating interactive API documentation, correctly formatted FinSpec documents can be used by developers to validate and mock APIs, acclerating development and reducing errors.


The current version of the FinSpec specification is 2.1: To read more about the schema definition: Get Started.

FinSpec schema versions in the 2.x series are actively supported. 1.x versions are now deprecated, while support for 0.x versions is now withdrawn.

We would strongly recommend upgrading to 2.1 as soon as possible. Please contact for (free) assistance to upgrade schema version.

Revision History

Version Date Notes
[2.1] 2019-01-18 Update to workflow schema.
[2.0] 2018-06-27 Support for navigation and history keys. Extended block (component) support. Retire 0.x versions.
[1.2] 2018-02-14 Support for machine readable bit fields.
[1.1] 2017-03-10 Support for functional (context-specific) messages.
[1.0] 2017-02-28 Enhanced protocol metadata, informational messages and change history.
[0.3] 2016-04-29 Add support for finite state machine workflow.
[0.2] 2016-03-16 Datatypes related enhancements. Added conditions block to field.
[0.1] 2016-01-06 Initial release of FinSpec Specification.

Schema Validation

We STRONGLY recommend validating FinSpec schema validation prior to deployment or sharing with counterparties. You can find FinSpec Schema validator here.


Copyright 2019 FixSpec Limited

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.