Skip to content
Metrifly Metrifly Metrifly Developer Docs

Push trades

Prerequisites

Section titled “Prerequisites”
  • transactions:write scope for the target portfolio.
  • Trade dates, symbols, quantities, prices, currency, and fees from your source system.

Submit a trade to the portfolio-scoped trades endpoint.

Terminal window
curl https://api.metrifly.com/v1/portfolios/pf_123/trades \
  -X POST \
  -H "Authorization: ApiKey $METRIFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "BUY",
    "ticker": "BHP",
    "exchange": "ASX",
    "quantity": "10",
    "price": "44.12",
    "currency": "AUD",
    "date": "2026-06-23",
    "fee": "9.50",
    "feeCurrency": "AUD",
    "broker": "Partner source"
  }'

The API returns the created transaction. To check historical import jobs created through Metrifly import flows, use the portfolio-scoped import status endpoint.

Terminal window
curl https://api.metrifly.com/v1/portfolios/pf_123/imports/imp_123 \
  -H "Authorization: ApiKey $METRIFLY_API_KEY"

Use stable notes or broker references from your source system so support investigations are deterministic.