Make an order

POST 
http://localhost:8080/api/v1/orders/exchange/confirm

Create an FX order based on the provided request.

Request

Header Parameters

ApiKey stringrequired
AccountId stringrequired

application/json

Body

required

quoteId uuidrequired

The unique ID of the quote for the exchange

externalId stringrequired

A unique identifier for this request, generated by the client

Responses

201

Created

application/json

Schema

Schema

id uuidrequired

Unique ID of the exchange

shortId stringrequired

Short ID of the exchange

externalId stringrequired

External ID of the exchange

rate objectrequired

Rate of the exchange

price numberrequired

currencyPair stringrequired

type stringrequired

Possible values: [BID, OFFER]

from objectrequired

amount numberrequired

The specific monetary value that is being converted from in the currency exchange

currency stringrequired

Possible values: Value must match regular expression [A-Z]{3}

The type of currency that the money is being exchanged from

to objectrequired

amount numberrequired

The specific monetary value that is being converted from in the currency exchange

currency stringrequired

Possible values: Value must match regular expression [A-Z]{3}

The type of currency that the money is being exchanged from

settlementDate daterequired

Settlement date of the exchange

exchangeStatus objectrequired

Status of the exchange

state stringrequired

Possible values: [DRAFT, SUBMITTING, UNKNOWN, SUBMITTED, ORDERED, ORDER_SETTLED, SUCCESS, REJECTED, FAILED, CANCELLED]

The current state of the exchange process

reason string

Possible values: [DRAFT, SUBMITTING, UNKNOWN, SUBMITTED, ORDERED, ORDER_SETTLED, SUCCESS, REJECTED, FAILED, FAILED_BREACHES_LIMIT, CANCELLED]

Reason for the exchange state

complete boolean

Completion status of the exchange

createdAt date-timerequired

Creation time of the exchange

completedAt date-time

Completion time of the exchange

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "shortId": "TR123",
  "externalId": "EX123",
  "rate": {
    "price": 0,
    "currencyPair": "string",
    "type": "BID"
  },
  "from": {
    "amount": 100,
    "currency": "USD"
  },
  "to": {
    "amount": 100,
    "currency": "USD"
  },
  "settlementDate": "2023-12-31",
  "exchangeStatus": {
    "state": "SUBMITTED",
    "reason": "REJECTED_BREACHES_LIMIT",
    "complete": false
  },
  "createdAt": "2023-01-01T00:00:00Z",
  "completedAt": "2023-01-02T00:00:00Z"
}

400

Bad Request

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

401

Unauthorized

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

403

Forbidden

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

404

Not Found

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

405

Method Not Allowed

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

415

Unsupported Media Type

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

429

Too Many Requests

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

500

Internal Server Error

application/json

Schema

Schema

type uri
title string
status int32
detail string
instance uri
properties object
property name* object

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "properties": {}
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'http://localhost:8080/api/v1/orders/exchange/confirm' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "quoteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "externalId": "clientGeneratedId"
}'

Request Collapse all

Base URL

http://localhost:8080

Parameters

ApiKey — headerrequired

AccountId — headerrequired

Body required

{
  "quoteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "externalId": "clientGeneratedId"
}

ResponseClear

Click the Send API Request button above and see the response here!