List returning positions

GET

/positions:returning

List positions currently in the return workflow

Request

Query Params

Responses

🟢200

application/json

Headers

Bodyapplication/json

🟠400

🟠403

🟠422

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tokenet-ng-api.digitalprimetechnologies.co/positions:returning?pageSize=10&pageToken=MTI%3D&orderBy=order_id_pretty&orderDir=asc&side=undefined&asset=BTC&counterparty=Acme%20Capital%2CBeta%20Lending&status=FAILED%2CASSET_TRANSFER_IN_PROGRESS&tradeDateFrom=2026-03-01&tradeDateTo=2026-03-31'

Response Example

200 - Success

{
    "next_page_token": "MTI=",
    "positions": [
        {
            "asset": "BTC",
            "asset_custodian": "Anchorage",
            "collateral_asset": "USDC",
            "collateral_custodian": "Anchorage",
            "collateral_type": "BILATERAL",
            "contract_value": "1000",
            "counterparty": "Acme Capital",
            "failure_time": "2026-05-21T12:00:00Z",
            "market_value": "1000",
            "order_id": "orders/11111111-1111-1111-1111-111111111111",
            "order_id_pretty": 10123,
            "price": "1000",
            "quantity": "1.5",
            "rate": 4.25,
            "requirement_percent": 105,
            "side": "BORROW",
            "status": "ASSET_TRANSFER_IN_PROGRESS",
            "trade_date": "2026-05-21T12:00:00Z"
        }
    ]
}

Modified at 2026-06-16 11:15:56

List pending positions

Preview position return transfer