Positions Upload

POST https://{environment_name}-api.fundapps.co/v3/data/positions/upload?snapshotDate=yyyy-mm-dd

Explanation

The Positions Upload (v3) API allows for a unified upload endpoint where it is possible to upload position data regardless of your file format or enabled data products.

Currently we accept the following file formats to the v3 upload endpoint:

CSV clients using Data Adapter for market data enrichment and any data product add-ons
XML clients using any data product add-ons
CSV clients using our transformation services for Position Limits commodities
Coming Soon: XML clients without data product add-ons

Once your position data is uploaded, the progress of the upload can be monitored through our status api endpoint.

Query Parameters

The snapshotDate parameter must be included as a parameter in the format yyyy-mm-dd when uploading CSV files. This is the snapshot date of the positions being uploaded in the csv file.

This field is not required for XML clients, as the snapshotDate is already provided in the XML file.

Request Parameters

The positions parameter must be the file that you need to upload.

Headers

We require the following headers attached the request

X-FundApps-File-Format

The X-FundApps-File-Format header is used to indicate the file format attached, including the shape of the file uploaded. The possible values are as follows:

csv/positions - CSV clients using the FundApps CSV file specification should use this value
xml/positions - XML clients using the FundApps XML file specification should use this value
csv/consensys - CSV clients using our Consensys file transformation capabilities should use this value

Please note: the above header should be used separately from any Content-Type headers used about the file. For example, if you upload a zip file with a FundApps CSV file inside, please use X-FundApps-File-Format: csv/positions

Authorization

This endpoint uses Basic authentication, for more information please see Authentication for more details.

Example: Authorization: Basic ZW1haWxAZW1haWwuY29tOnBhc3N3b3Jk

Example File

PortfolioId,AssetId,AssetName,ISIN,SEDOL,DataProviderId,ComponentDataProviderId,Quantity,MarketValue,SFTType,CUSIP,Price,InstrumentCurrency,AssetClass,ComponentISIN,IsCashSettled
11,US0378331005,Apple Inc,US0378331005,B0YQ5W0,,,10000,10000000,Normal,037833100,100,USD,,,
11,B10RVH1,Microsoft Inc,,B10RVH1,,,355310000,355310000,Normal,,10,USD,,,
11,DE0005190003,BMW AG,DE0005190003,,,,500,10000,Normal,,14,EUR,,,
11,GB0006043169,Aldi,GB0006043169,,,,425500,42550000,Normal,,10,GBP,,,
11,US49639K1016,Kingsoft Cloud ADR,US49639K1016,,,,3999940,3914832480,Normal,,10.4,USD,,,
11,UnlistedSwap,OTC Swap with exchange traded component,,,,,30000,422409000,Normal,,5,USD,Swap,GB0006043169,FALSE
11,UnlistedSwapVod,OTC Swap with exchange traded component VOD,,,,VOD.L,30000,422409000,Normal,,5,USD,Swap,,FALSE
11,VOD_EQ_XLON,Vodafone,,,VOD.L,,20000,2012400,Normal,,100.62,GBP,,,
11,ALTG_O_XMOD,ALTUS GROUP LIMITED (AIF) OPTIONS,,,AIFL152305000.M,,10000,1000000,Normal,,100,CAD,,,

<?xml version="1.0" encoding="UTF-8"?>
<Snapshot Date="2015-02-22">
    <Instruments>
        <Equity InstrumentId="FI0009000681" InstrumentName="Nokia Equity" IssuerId="1" IssuerName="Nokia" ISIN="FI0009000681" CountryOfIssue="FI" CountryOfIncorporation="FI" TotalVotingRights="3000" ClassSharesOutstanding="1000" TotalSharesOutstanding="2000" TotalSharesInTreasury="200" InstrumentCurrency="GBP" VotesPerShare="3" Market="XHEL" MarketsListedIn="XHEL" Price="10" CUSIP=""/>
    </Instruments> 
    <Portfolios>
        <Portfolio PortfolioId="11">
            <Asset AssetId="FI0009000681XHEL" AssetName="Nokia Equity" InstrumentId="FI0009000681" Quantity="10"/>
        </Portfolio>
    </Portfolios>
</Snapshot>

Source System,Account,Account Name,Account Type,Trader,Contract Month,Exchange Code,Product Code,Product Type,Option Type,Exchange Clearing ID,Product Description,Currency,Strike,Strike Type,Expiry Date,Last Trade Date,Option Delta,Buy/Sell,Quantity,Initial Margin,As of Date,Is Cash Settled,Contract Size,FIA Tech Code
Bloomberg,1,1,,,202109,CBT,TYU1 Comdty,F,,TYU1 Comdty,US 10YR NOTE (CBT)Sep21,USD,,,,20210921,,,100,,20210701,TRUE,100,21

Example Upload Script

🦉

*New Positions Upload - v3

Open Recipe

Example Response

{
  "id": "9b134cda-81db-44c0-9c52-cfeb897e663a",
  "dateCreated": "2025-03-18T13:45:56.7060539Z",
  "status": "InProgress",
  "hasWarnings": false
}