Helpdesk
  • Overview
    • Welcome to Finery Markets
    • About Our Products
      • FM Liquidity Match
        • Master Account
        • Sub-Account
      • FM Pulse
      • White Label solution
  • Product Features
    • Onboarding
    • Risk Management
    • Trading
      • Aggregated Order Book
      • Firm Order Book
      • Pending Limit Orders (GTC)
      • RFQ
      • Toxic Flow Protection
      • Markups
      • Authorized trading
      • Non-Deliverable Trading
      • Voice Trading
      • Interdealer Trading
    • Position Management
    • Settlements
      • Automated Settlements
      • Addresses
    • Control Center
      • Multi-Roles
      • Notifications
      • Reporting
      • Bulk Edit
    • Referral program
  • API Reference
    • Quick Start with API
      • For Market Makers
      • For Takers
    • Data Types
    • REST API
      • Client management
        • getSubaccounts
      • RFQ
        • getSettings
        • getSettings (authorized)
        • getUserSettings (authorized)
        • setUserSettings (authorized)
        • getProviders
        • getSessions
      • Trading
        • add
        • add (authorized)
        • Pending limit orders
          • add (pending limit order)
          • add (pending limit order) (authorized)
          • del
          • del (authorized)
          • delAll
          • delAll (authorized)
          • orders
          • orders (authorized)
        • mod
        • del
        • delAll
        • book
        • voiceTrade
        • liquidationTrade
        • dealHistory
        • dealHistory (authorized)
        • instruments
        • positions
        • instrumentMarkups
        • addInstrumentMarkups
        • delInstrumentMarkups
      • Settlements
        • settlementRequests
        • settlementOrders
        • settlementTransactions
        • settlementHistory
        • settlementTransactionHistory
        • addIncomingSettlementRequest
        • delIncomingSettlementRequest
        • delIncomingSettlementCPRequest
        • addOutgoingSettlementTransaction
        • addIncomingSettlementTransaction
        • sendSettlementTransaction
        • commitIncomingSettlementTransaction
        • delSettlementTransaction
      • Risk Management
        • climits
        • setCLimit
        • delCLimit
        • subaccountsLimits
        • setSubaccountLimit
        • delSubaccountLimit
        • enableTrading
        • disableTrading
        • cAssetLimits
        • setCAssetLimit
        • delCAssetLimit
        • cShortSalesBan
        • setShortSalesBan
        • delShortSalesBan
        • enableInstrumentsWhitelist
        • setInstrumentsWhitelist
        • disableInstrumentsWhitelist
        • instrumentsWhitelist
      • Non-deliverable Trading
        • settings/getOvernightRates
        • settings/setOvernightRates
    • Websocket API
      • Feed 'A' - Assets
      • Feed 'P' - Positions
      • Feed 'L' - Counterparty limits
      • Feed 'B' - Global order books
      • Feed 'F' - Tradable order books
      • Feed 'R' - Settlement requests
      • Feed 'N' - Settlement transactions
      • Feed 'K' - Positions
      • Feed 'O' - Orders
      • Feed 'S' - Settlement orders
      • RFQ
    • FIX API
      • Admin messages
      • Market Data
      • Trade
        • Trading for Takers
        • Trading for LPs and Masters
    • Troubleshooting Errors
      • List of Error Codes
      • Error 3
      • Error 6
      • Error 7
      • Error 14
Powered by GitBook
On this page

Last updated 2 months ago

POST api/positions

Request parameters

Field name
Type
Description

Response description

Fiels name
Type
Description
{
    "error": 2
}
  1. API Reference
  2. REST API
  3. Trading

positions

Returns next deal id, positions, orders and settlement orders snapshot

PreviousinstrumentsNextinstrumentMarkups
{
    "filter": "all"
}
[
    5,
    [
        [ 
            "BTC",        // Posititon Currency
            -10000000,    // Value
            2,            // Counterparty id
            0,            // Max reachable position, if the settlement order is committed
            -10000000     // Min reachable position
        ],
        [
            "USD",
            100000000000,
            2,
            100000000000,
            0,
        ]
    ],
    [
        [
            "BTC-USD",     // Order instrument
            0,             // Order type
            0,             // Side
            0,             // Cancel reason
            1234,          // Order id
            0,             // Client order id 
            999900000000,  // Price
            10000000,      // Size or volume
            8000000,       // Remaining size or volume
            1558051200000, // Created at
            0              // created by size or volume
        ]
    ],
    [
        [
            1229,          // Settlement order id
            "BTC",         // Currency 1
            "USD",         // Currency 2
            10000000,      // Size 1
            100000000000,  // Size 2
            1558050900000, // Created at
            2,             // Counterparty id
            "BTC",         // Network name 1
            ""             // Network name 2 (not specified)    
        ]
    ]
]

filter

string

Optional field for master accounts only (FM Liquidity Match). - absent or "all": returns positions for all counterparties - "subaccounts": returns positions for the sub-accounts - "external": returns positions for external counterparties

Array[4]

Array or 4 elements

0

Efx::DealId

Next Deal or Settlement Id

1

Array of Positions

Asset Positions

2

Array of Orders

Active Orders (for makers only)

3

Array of SettlementOrders

Active Settlement Orders

Position

Array[3]

0

string

Currency name

1

Efx::Size

Value

2

Efx::ClientId

Counterparty Id

3

Efx::Size

4

Efx::Size

Order

Array[11]

0

string

Instrument name

1

unsigned int16

Order Type

0 - limit

1 - post only

2 - limit IOC

3 - limit FOK

4 - market IOC

5 - market FOK 6 - manual trade 7 - pending limit 9 - RFQ

2

Efx::Side

Side

0 - bid

1 - ask

3

unsigned int16

Cancel reason

0 - in place or filled

1 - by client

2 - as non-book order

3 - by self-trade prevention

4 - cancel-on-disconnect

4

Efx::OrderId

Order Id

5

Efx::ClientOrderId

Client Order Id

6

Efx::Price

Order price

7

Efx::Size

Order Initial Size Or Volume (Depending on Order was initially created by size or volume)

8

Efx::Size

Remaining Order Size Or Volume (Depending on Order was initially created by size or volume)

9

Efx::Timestamp

Created At

10

unsigned int16

If order was created by size or by volume

0 - by size

1 - by volume

SettlementOrder

Array[9]

0

Efx::OrderId

Settlement order id

1

string

Currency 1

2

string

Currency 2

3

Efx::Size

Size 1

4

Efx::Size

Size 2

5

Efx::Timestamp

Created At

6

Efx::ClientId

Counterparty id

7

string

Newtork 1 or empty

8

string

Network 2 or empty

Max reachable position
Min reachable position