Tokenet API
  1. Positions
Tokenet API
  • Tokenet API
  • Introduction
  • Signing a Request
  • Rate Limiting
  • Realtime Event Streams (SSE)
  • Orders
    • List supported custodians
      GET
    • List active orders
      GET
    • Create order
      POST
    • Get order
      GET
    • Update order
      PUT
    • Cancel order
      POST
    • List available assets
      GET
    • List available custodians
      GET
    • Calculate prices
      POST
    • Export active orders CSV
      GET
  • Mark To Market
    • List mark-to-market requests
    • Create mark-to-market request
    • Get mark-to-market request
    • Accept mark-to-market request
    • Reject mark-to-market request
    • Retry mark-to-market request
    • Get mark-to-market request transfer preview
    • Export mark-to-market requests CSV
    • Preview mark-to-market request modal
    • Preview mark-to-market transfer
  • Order Requests
    • Create order request
    • Update order request
  • Notifications
    • List organization notifications
    • Mark notification as read
  • Positions
    • Accept position rerate
      POST
    • Reject position rerate
      POST
    • List positions
      GET
    • Get position by order public ID
      GET
    • Get position
      GET
    • Create position return
      POST
    • Complete return asset transfer
      POST
    • Release return collateral
      POST
    • Create position recall
      POST
    • Create position rerate
      POST
    • Get asset portfolio dashboard stats
      GET
    • Export positions CSV
      GET
    • List pending positions
      GET
    • List returning positions
      GET
    • Preview position return transfer
      POST
  • Transfers
    • List transfers
    • Get transfer
  • Reports
    • List activity report
    • Export activity report CSV
    • List collateral report
    • Export collateral report CSV
    • Get counterparty exposure report
    • Export counterparty exposure report CSV
    • Get fee charge and accrual report
    • Export fee charge and accrual report CSV
    • Export transfers report CSV
    • List transfers report
  • Chats
    • Create chat group
    • Get chat group details
    • Create mark review message
    • Accept chat action
    • Reject chat action
    • List chat participants
    • List chat threads
    • List chat messages
    • Create chat message
    • Mark chat thread read
    • Open direct chat thread
    • List chat users
  • Schemas
    • AcceptInvitationBody
    • AccountResource
    • ActivityReportEmployeeResource
    • ActivityReportOrganizationResource
    • ActivityReportPositionResource
    • ActivityReportResource
    • AddOrganizationAccountBody
    • AddOrganizationAccountResource
    • AnchorageAPIKeyResponseBody
    • AnchorageBalanceItem
    • AnchorageBalanceResponseBody
    • AnchorageBalanceWallet
    • AnchorageCredentialsField
    • AnchorageDepositAddress
    • AnchoragePage
    • AnchoragePublicKeyResponseBody
    • AnchorageVault
    • AnchorageVaultAccount
    • AnchorageVaultWallet
    • AnchorageVaultWalletsResponseBody
    • AnchorageVaultsResponseBody
    • AnchorageWalletAsset
    • AnchorageWalletBalance
    • ApiCredentialResponseBody
    • ApiCredentialWithKeyResponseBody
    • AssetPortfolioDashboardStatsResource
    • AuditLogEntryResponseBody
    • AvailableAssetResource
    • AvailableCustodianResource
    • BitGoReadinessResponseBody
    • BitGoSetupStatusResponseBody
    • BitGoWallet
    • BitGoWalletAssetBalance
    • BitGoWalletRefreshResponseBody
    • BitGoWalletTransfer
    • BitGoWalletTransfersResponseBody
    • BitGoWalletWebhookIngestionResponseBody
    • BitGoWalletsResponseBody
    • BitGoWebhookVerificationResponseBody
    • CalculatePrices
    • CalculatePricesRequest
    • CalculatePricesResponseBody
    • CancelOrderResource
    • CancelOrderResponseBody
    • ChangePasswordBody
    • ChangePasswordResponseBody
    • ChatGroupDetailsResource
    • ChatMessageActionResource
    • ChatMessageResource
    • ChatParticipantOptionResource
    • ChatParticipantOrganizationResource
    • ChatParticipantResource
    • ChatTabCountResource
    • ChatThreadLastMessageResource
    • ChatThreadResource
    • ClientFeatureFlagStateResource
    • ClientRuleResource
    • CollateralReportRowResource
    • ConfigureAnchorageKeysBody
    • ConfigureAnchorageKeysResource
    • ConfigureAnchorageResponseBody
    • ConfigureAnchorageVaultIDBody
    • ConfigureAnchorageVaultIDResource
    • ConfigureBitGoAccessTokenBody
    • ConfigureBitGoAccessTokenResource
    • ConfigureBitGoEnterpriseBody
    • ConfigureBitGoEnterpriseResource
    • ConfigureBitGoHotWalletSignerKeychain
    • ConfigureBitGoHotWalletSignerMaterialBody
    • ConfigureBitGoHotWalletSignerMaterialResource
    • ConfigureBitGoResponseBody
    • ConfigureProviderBitGoAccessTokenBody
    • ConfigureProviderBitGoAccessTokenResource
    • ConfigureProviderBitGoEnterpriseBody
    • ConfigureProviderBitGoEnterpriseResource
    • CounterpartyExposureReportRowResource
    • CreateAPICredentialBody
    • CreateAccountResponseBody
    • CreateChatGroupBody
    • CreateChatGroupResponseBody
    • CreateChatMessageBody
    • CreateChatMessageResponseBody
    • CreateM2MRequestBody
    • CreateM2MResponseBody
    • CreateMarkChatThreadBody
    • CreateMarkChatThreadResponseBody
    • CreateOrderBody
    • CreateOrderRequest
    • CreateOrderRequestBody
    • CreateOrderRequestResponseBody
    • CreateOrderResource
    • CreateOrderResponseBody
    • CreateOrganizationBody
    • CreateOrganizationResource
    • CreateOrganizationResponseBody
    • CreatePositionRerateBody
    • CreatePositionReturnBody
    • EmailNotificationCategoryResource
    • EmailNotificationEventResource
    • EmailNotificationSettingsResource
    • ErrorDetail
    • ExecuteTransferBody
    • ExecuteTransferResponseBody
    • FeatureFlagResource
    • FeatureFlagRevisionResource
    • FeeChargeAndAccrualReportRowResource
    • FieldMask
    • GetAccountResponseBody
    • GetAdminFeatureFlagsResponseBody
    • GetAssetPortfolioDashboardStatsResponseBody
    • GetChatGroupDetailsResponseBody
    • GetCounterpartyExposureReportResponseBody
    • GetFeatureFlagHistoryResponseBody
    • GetFeatureFlagsResponseBody
    • GetFeeChargeAndAccrualReportResponseBody
    • GetM2MRequestBody
    • GetOrderResponseBody
    • GetOrganizationResponseBody
    • GetPositionResponseBody
    • GetTransferResponseBody
    • GetUserSettingsResponseBody
    • InvitationResponseBody
    • InviteAccount
    • InviteAccountBody
    • ListAPICredentialLogsResponseBody
    • ListAPICredentialsResponseBody
    • ListAccountsResponseBody
    • ListActivityReports
    • ListAvailableAssetsResponseBody
    • ListAvailableCustodiansResponseBody
    • ListChatMessagesResponseBody
    • ListChatParticipantsResponseBody
    • ListChatThreadsResponseBody
    • ListClientRulesResponseBody
    • ListCollateralReport
    • ListM2MRequestsBody
    • ListNotificationsResponseBody
    • ListOrdersResponseBody
    • ListOrganizationsResponseBody
    • ListOrganizationsWithAnchorageCredentialsResponseBody
    • ListPendingPositionsResponseBody
    • ListPositions
    • ListPositionsResponseBody
    • ListReturningPositionsResponseBody
    • ListTransfersReportResponseBody
    • ListTransfersResponseBody
    • LoginBody
    • LoginResponseBody
    • M2MColumnPreferencesResource
    • M2MPositionPreviewResource
    • M2MPositionPreviewResponseBody
    • M2MPreviewPartyResource
    • M2MRequestActionBody
    • M2MRequestResource
    • M2MTransferPreviewResource
    • M2MTransferPreviewResponseBody
    • MarkNotificationReadResponseBody
    • MembershipResource
    • NotificationResource
    • OpenDirectChatThreadBody
    • OpenDirectChatThreadResponseBody
    • OrderResource
    • OrganizationAnchorageCredentialsResource
    • OrganizationResource
    • PendingPositionActionGuidanceResource
    • PendingPositionResource
    • PermissionResource
    • PortfolioLastDealResource
    • PositionAccrualSegmentResource
    • PositionAccrualSummaryResource
    • PositionActionAvailabilityResource
    • PositionRecallResource
    • PositionRecallResponseBody
    • PositionRerateResource
    • PositionRerateResponseBody
    • PositionResource
    • PositionReturnResource
    • PositionReturnResponseBody
    • PositionReturnTransferLegResource
    • PositionReturnTransferPartyResource
    • PositionReturnTransferPreviewResource
    • PositionReturnTransferPreviewResponseBody
    • PreviewM2MTransferBody
    • ProviderLifecycleResource
    • RESTErrorModel
    • RequestPasswordChangeBody
    • RequestPasswordChangeResponseBody
    • ResolveChatActionBody
    • ResolveChatActionResponseBody
    • RoleResource
    • RollbackFeatureFlagBody
    • RollbackFeatureFlagResponseBody
    • StartLoginResponseBody
    • TransferPartyRef
    • TransferResource
    • TransfersReportRowResource
    • TripartyActionGuidanceResource
    • TripartyReadinessResource
    • TripartyReferencesResource
    • TripartyRequiredActionResource
    • TripartyResource
    • UpdateAccountBody
    • UpdateAccountResource
    • UpdateAccountResponseBody
    • UpdateClientRuleBody
    • UpdateClientRuleResource
    • UpdateClientRuleResponseBody
    • UpdateEmailNotificationCategoryResource
    • UpdateEmailNotificationSettingsResource
    • UpdateFeatureFlagBody
    • UpdateFeatureFlagResource
    • UpdateFeatureFlagResponseBody
    • UpdateM2MColumnPreferencesResource
    • UpdateOrderBody
    • UpdateOrderRequest
    • UpdateOrderRequestBody
    • UpdateOrderRequestResponseBody
    • UpdateOrderResource
    • UpdateOrderResponseBody
    • UpdateOrganizationBody
    • UpdateOrganizationResource
    • UpdateOrganizationResponseBody
    • UpdatePasswordBody
    • UpdatePasswordResponseBody
    • UpdateUserSettingsBody
    • UpdateUserSettingsResource
    • UpdateUserSettingsResponseBody
    • UpdateUserSettingsResponseResource
    • UserSettingsResource
    • ValidateTripartyBody
    • ValidateTripartyResponseBody
    • VerifyBitGoWebhookNotificationBody
    • VerifyBitGoWebhookNotificationResource
    • VerifyLoginOTPBody
    • VerifyOTPBody
    • VerifyOTPResponseBody
  1. Positions

Get position

GET
/positions/{position_id}
Get position by id.

Request

Path Params

Responses

🟢200
application/json
OK
Headers

Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://tokenet-ng-api.digitalprimetechnologies.co/positions/7c9e6679-7425-40de-944b-e07fc1f90ae7'
Response Response Example
200 - Success
{
    "position": {
        "asset": "ETHSEP",
        "collateral_asset": "BTC_S",
        "collateral_type": "RESTRICTED",
        "contract_value": 123123.12312,
        "counterparty": "7d1f1405-3fd8-49d2-9552-99e9692c32ds",
        "display_status": "Active (Rerated)",
        "market_value": 1764.124,
        "normalized_asset": "ETH",
        "normalized_collateral_asset": "BTC",
        "order_id": "7d1f1405-3fd8-49d2-9552-99e9692c32db",
        "order_id_pretty": 10123,
        "previous_contract_value": 129279.27928,
        "price": 10000,
        "quantity": 0.4512,
        "rate": "3.25",
        "recall_active": false,
        "requirement_percent": 105,
        "rerate": {
            "borrower_organization_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
            "contract_id": "550e8400-e29b-41d4-a716-446655440000",
            "create_time": "2026-03-03T12:00:00Z",
            "current_m2m": "12500",
            "fees": "0",
            "frozen_accrued_interest": "0",
            "id": "11c66022-191a-44fb-a45e-ec7f730edb8b",
            "initiated_by_account_id": "9a3f7e9a-0e3e-4f73-9a5b-2c9f18c3f8a1",
            "initiated_by_name": "Alex Johnson",
            "lender_organization_id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
            "m2m_at_rerate": "0",
            "m2m_delta_since_rerate": "0",
            "new_rate": 4.5,
            "old_rate": 3.25,
            "outstanding_principal": "0",
            "position_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
            "status": "requested",
            "unrealized_pnl": "0",
            "update_time": "2026-03-03T12:00:00Z"
        },
        "rerated": true,
        "status": "active",
        "trade_date": "2026-01-26T19:49:10Z"
    }
}
Modified at 2026-06-16 11:15:56
Previous
Get position by order public ID
Next
Create position return
Built with