List Allocation Actions

curl --request GET \
  --url https://api.dfns.io/allocations/{allocationId}/actions \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "id": "allctn-a-6a3ku-bn8d7-8u5rs1oukojms7k8",
      "allocationId": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
      "externalId": "external-action-123",
      "kind": "Deposit",
      "status": "InProgress",
      "requester": {
        "userId": "us-3v1ag-v6b36-afhm4zy59kjrn1fds",
        "tokenId": "ut-341e5-12nj6-9a82ld2hjxqzkpji"
      },
      "requestBody": {
        "kind": "Deposit",
        "sourceAsset": {
          "kind": "Erc20",
          "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "amount": "500000000"
        },
        "targetAsset": {
          "kind": "Erc20",
          "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
          "amount": "500000000"
        },
        "slippageBps": 100
      },
      "dateCreated": "2025-10-09T11:15:33.421Z"
    }
  ],
  "nextPageToken": "<string>"
}

GET

allocations

{allocationId}

actions

List Allocation Actions

curl --request GET \
  --url https://api.dfns.io/allocations/{allocationId}/actions \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "id": "allctn-a-6a3ku-bn8d7-8u5rs1oukojms7k8",
      "allocationId": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
      "externalId": "external-action-123",
      "kind": "Deposit",
      "status": "InProgress",
      "requester": {
        "userId": "us-3v1ag-v6b36-afhm4zy59kjrn1fds",
        "tokenId": "ut-341e5-12nj6-9a82ld2hjxqzkpji"
      },
      "requestBody": {
        "kind": "Deposit",
        "sourceAsset": {
          "kind": "Erc20",
          "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "amount": "500000000"
        },
        "targetAsset": {
          "kind": "Erc20",
          "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
          "amount": "500000000"
        },
        "slippageBps": 100
      },
      "dateCreated": "2025-10-09T11:15:33.421Z"
    }
  ],
  "nextPageToken": "<string>"
}

Authentication

❌ Account User (AccountUser)
✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Allocations:Read: Always required.

Authorizations

Authorization

string

header

required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

allocationId

string

required

Unique identifier for the allocation investment.

Required string length: 1 - 64

Query Parameters

limit

integer

default:50

Maximum number of items to return.

Required range: 1 <= x <= 500

paginationToken

string

Opaque token used to retrieve the next page. Returned as nextPageToken from the previous request.

Minimum string length: 1

Response

200 - application/json

Success

items

object[]

required

Current page items.

Show child attributes

items.id

string

required

Unique identifier for the allocation action.

Required string length: 1 - 64

Example:

"allctn-a-04p5n-gkkgd-5qk71nuev5n2ug1t"

items.allocationId

string

required

Unique identifier for the allocation investment.

Required string length: 1 - 64

Example:

"allctn-7mnn0-rltpq-9bvps60gjm09td0j"

items.kind

enum<string>

required

The type of action being performed on the allocation investment: Deposit to add funds or Withdraw to remove funds.

Available options:

Deposit,

Withdraw

items.status

enum<string>

required

Status of the allocation action. Once initiated, the status will be InProgress, after processing it will be Completed or Failed.

Available options:

PendingPolicyApproval,

InProgress,

Completed,

Failed,

Rejected

items.requester

object

required

Show child attributes

items.requester.userId

string

required

User (could be a service account) who requested the resource.

Required string length: 1 - 64

Example:

"us-6b58p-r53sr-rlrd3l5cj3uc4ome"

items.requester.tokenId

string

Service Account token or Personal Access token used when requesting the resource.

Required string length: 1 - 64

Example:

"to-202a0-cdo33-o65mbt6q758lvvnt"

items.requestBody

0fns Allocation Action Request · object

required

The full request used for initiating this allocation action.

0fns Allocation Action Request
0fns Allocation Request

Show child attributes

items.requestBody.kind

enum<string>

required

The type of action being performed on the allocation investment: Deposit to add funds or Withdraw to remove funds.

Available options:

Deposit,

Withdraw

items.requestBody.sourceAsset

EVM Fungible Token (ERC-20) · object

required

Show child attributes

items.requestBody.sourceAsset.kind

enum<string>

required

Available options:

Erc20

items.requestBody.sourceAsset.contract

string

required

items.requestBody.sourceAsset.amount

string

required

items.requestBody.targetAsset

EVM Fungible Token (ERC-20) · object

required

Show child attributes

items.requestBody.targetAsset.kind

enum<string>

required

Available options:

Erc20

items.requestBody.targetAsset.contract

string

required

items.requestBody.targetAsset.amount

string

required

items.requestBody.slippageBps

number

required

The slippage tolerance for this trade in basis point (BPS). Slippage tolerance defines the maximum price difference you're willing to accept during a trade from the estimated quote, ensuring you still receive at least a minimum number of tokens if the price shifts. One basis point equals one-hundredth of a percentage point, or 0.01%.

items.requestBody.externalId

string

An optional external identifier provided by the client to ensure idempotency and prevent duplicate operations.

items.dateCreated

string<date-time>

required

ISO 8601 date (must be UTC). ISO 8601 date. When the allocation action was created.

Example:

"2023-04-14T20:41:28.715Z"

items.externalId

string

An optional external identifier provided by the client to ensure idempotency and prevent duplicate operations.

items.failureReason

string

The failure reason, if any. Only present when status is Failed.

nextPageToken

string

token to use as paginationToken to request the next page.

Get Allocation

Create Allocation Action

⌘I

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

List Allocation Actions

Authentication

Required Permissions

Authorizations

Path Parameters

Query Parameters

Response

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

​Authentication

​Required Permissions

Authorizations

Path Parameters

Query Parameters

Response

Authentication

Required Permissions