Create Allocation

curl --request POST \
  --url https://api.dfns.io/allocations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "externalId": "ext-123",
  "sourceAsset": {
    "kind": "Erc20",
    "contract": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "amount": "1000000000000000000"
  },
  "targetAsset": {
    "kind": "Erc20",
    "contract": "0x5d3a536e4d6dbd6114cc1ead35777bab948e3643",
    "amount": "32000000000000000000"
  },
  "slippageBps": 50,
  "walletId": "wa-4g991-s29to-9hrq4nbuto6ih33b",
  "protocol": "0fns"
}
'

import requests

url = "https://api.dfns.io/allocations"

payload = {
    "externalId": "ext-123",
    "sourceAsset": {
        "kind": "Erc20",
        "contract": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "amount": "1000000000000000000"
    },
    "targetAsset": {
        "kind": "Erc20",
        "contract": "0x5d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "amount": "32000000000000000000"
    },
    "slippageBps": 50,
    "walletId": "wa-4g991-s29to-9hrq4nbuto6ih33b",
    "protocol": "0fns"
}
headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-DFNS-USERACTION': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    externalId: 'ext-123',
    sourceAsset: {
      kind: 'Erc20',
      contract: '0x6b175474e89094c44da98b954eedeac495271d0f',
      amount: '1000000000000000000'
    },
    targetAsset: {
      kind: 'Erc20',
      contract: '0x5d3a536e4d6dbd6114cc1ead35777bab948e3643',
      amount: '32000000000000000000'
    },
    slippageBps: 50,
    walletId: 'wa-4g991-s29to-9hrq4nbuto6ih33b',
    protocol: '0fns'
  })
};

fetch('https://api.dfns.io/allocations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dfns.io/allocations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'externalId' => 'ext-123',
    'sourceAsset' => [
        'kind' => 'Erc20',
        'contract' => '0x6b175474e89094c44da98b954eedeac495271d0f',
        'amount' => '1000000000000000000'
    ],
    'targetAsset' => [
        'kind' => 'Erc20',
        'contract' => '0x5d3a536e4d6dbd6114cc1ead35777bab948e3643',
        'amount' => '32000000000000000000'
    ],
    'slippageBps' => 50,
    'walletId' => 'wa-4g991-s29to-9hrq4nbuto6ih33b',
    'protocol' => '0fns'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-DFNS-USERACTION: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dfns.io/allocations"

	payload := strings.NewReader("{\n  \"externalId\": \"ext-123\",\n  \"sourceAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"amount\": \"1000000000000000000\"\n  },\n  \"targetAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643\",\n    \"amount\": \"32000000000000000000\"\n  },\n  \"slippageBps\": 50,\n  \"walletId\": \"wa-4g991-s29to-9hrq4nbuto6ih33b\",\n  \"protocol\": \"0fns\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dfns.io/allocations")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalId\": \"ext-123\",\n  \"sourceAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"amount\": \"1000000000000000000\"\n  },\n  \"targetAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643\",\n    \"amount\": \"32000000000000000000\"\n  },\n  \"slippageBps\": 50,\n  \"walletId\": \"wa-4g991-s29to-9hrq4nbuto6ih33b\",\n  \"protocol\": \"0fns\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/allocations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"externalId\": \"ext-123\",\n  \"sourceAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"amount\": \"1000000000000000000\"\n  },\n  \"targetAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643\",\n    \"amount\": \"32000000000000000000\"\n  },\n  \"slippageBps\": 50,\n  \"walletId\": \"wa-4g991-s29to-9hrq4nbuto6ih33b\",\n  \"protocol\": \"0fns\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
  "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
  "protocol": "0fns",
  "provider": "M0",
  "amount": {
    "kind": "Erc20",
    "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
    "amount": "1000000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "0fns",
      "symbol": "0fnsSepolia",
      "decimals": 6,
      "tid": "erc20:0x0A7660979A67E4bC51E750C628C8479ff9F458aE"
    }
  },
  "rewards": {
    "kind": "Erc20",
    "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
    "amount": "5000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "0fns",
      "symbol": "0fnsSepolia",
      "decimals": 6,
      "tid": "erc20:0x0A7660979A67E4bC51E750C628C9479ff9F458aE"
    }
  },
  "dateCreated": "2025-10-09T10:57:55.758Z"
}

POST

allocations

Create Allocation

curl --request POST \
  --url https://api.dfns.io/allocations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "externalId": "ext-123",
  "sourceAsset": {
    "kind": "Erc20",
    "contract": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "amount": "1000000000000000000"
  },
  "targetAsset": {
    "kind": "Erc20",
    "contract": "0x5d3a536e4d6dbd6114cc1ead35777bab948e3643",
    "amount": "32000000000000000000"
  },
  "slippageBps": 50,
  "walletId": "wa-4g991-s29to-9hrq4nbuto6ih33b",
  "protocol": "0fns"
}
'

import requests

url = "https://api.dfns.io/allocations"

payload = {
    "externalId": "ext-123",
    "sourceAsset": {
        "kind": "Erc20",
        "contract": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "amount": "1000000000000000000"
    },
    "targetAsset": {
        "kind": "Erc20",
        "contract": "0x5d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "amount": "32000000000000000000"
    },
    "slippageBps": 50,
    "walletId": "wa-4g991-s29to-9hrq4nbuto6ih33b",
    "protocol": "0fns"
}
headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-DFNS-USERACTION': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    externalId: 'ext-123',
    sourceAsset: {
      kind: 'Erc20',
      contract: '0x6b175474e89094c44da98b954eedeac495271d0f',
      amount: '1000000000000000000'
    },
    targetAsset: {
      kind: 'Erc20',
      contract: '0x5d3a536e4d6dbd6114cc1ead35777bab948e3643',
      amount: '32000000000000000000'
    },
    slippageBps: 50,
    walletId: 'wa-4g991-s29to-9hrq4nbuto6ih33b',
    protocol: '0fns'
  })
};

fetch('https://api.dfns.io/allocations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dfns.io/allocations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'externalId' => 'ext-123',
    'sourceAsset' => [
        'kind' => 'Erc20',
        'contract' => '0x6b175474e89094c44da98b954eedeac495271d0f',
        'amount' => '1000000000000000000'
    ],
    'targetAsset' => [
        'kind' => 'Erc20',
        'contract' => '0x5d3a536e4d6dbd6114cc1ead35777bab948e3643',
        'amount' => '32000000000000000000'
    ],
    'slippageBps' => 50,
    'walletId' => 'wa-4g991-s29to-9hrq4nbuto6ih33b',
    'protocol' => '0fns'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-DFNS-USERACTION: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dfns.io/allocations"

	payload := strings.NewReader("{\n  \"externalId\": \"ext-123\",\n  \"sourceAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"amount\": \"1000000000000000000\"\n  },\n  \"targetAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643\",\n    \"amount\": \"32000000000000000000\"\n  },\n  \"slippageBps\": 50,\n  \"walletId\": \"wa-4g991-s29to-9hrq4nbuto6ih33b\",\n  \"protocol\": \"0fns\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dfns.io/allocations")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalId\": \"ext-123\",\n  \"sourceAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"amount\": \"1000000000000000000\"\n  },\n  \"targetAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643\",\n    \"amount\": \"32000000000000000000\"\n  },\n  \"slippageBps\": 50,\n  \"walletId\": \"wa-4g991-s29to-9hrq4nbuto6ih33b\",\n  \"protocol\": \"0fns\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/allocations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"externalId\": \"ext-123\",\n  \"sourceAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"amount\": \"1000000000000000000\"\n  },\n  \"targetAsset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643\",\n    \"amount\": \"32000000000000000000\"\n  },\n  \"slippageBps\": 50,\n  \"walletId\": \"wa-4g991-s29to-9hrq4nbuto6ih33b\",\n  \"protocol\": \"0fns\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
  "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
  "protocol": "0fns",
  "provider": "M0",
  "amount": {
    "kind": "Erc20",
    "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
    "amount": "1000000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "0fns",
      "symbol": "0fnsSepolia",
      "decimals": 6,
      "tid": "erc20:0x0A7660979A67E4bC51E750C628C8479ff9F458aE"
    }
  },
  "rewards": {
    "kind": "Erc20",
    "contract": "0x0A7660979A67E4bC51E750C628C8479ff9F458aE",
    "amount": "5000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "0fns",
      "symbol": "0fnsSepolia",
      "decimals": 6,
      "tid": "erc20:0x0A7660979A67E4bC51E750C628C9479ff9F458aE"
    }
  },
  "dateCreated": "2025-10-09T10:57:55.758Z"
}

Authentication

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

Required Permissions

Allocations:Create: Always required
Wallets:Transactions:Create: Always required. Allocation transactions are broadcast from your wallet.
FeeSponsors:Use: Required if feeSponsorId is specified.

Authorizations

Authorization

string

header

required

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

X-DFNS-USERACTION

string

header

required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Body

application/json

0fns Allocation Request
Sky sUSDS Allocation Request
Gauntlet gtUSDC Allocation Request
Steakhouse USDT Allocation Request
Gauntlet USDC Prime (Base) Allocation Request
Steakhouse USDC (Base) Allocation Request
Sentora PYUSD Main Allocation Request

Request body for creating an allocation investment.

walletId

string

required

Wallet id.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

protocol

enum<string>

required

Ofns protocol

Available options:

0fns

sourceAsset

EVM Fungible Token (ERC-20) · object

required

Show child attributes

targetAsset

EVM Fungible Token (ERC-20) · object

required

Show child attributes

slippageBps

integer

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%.

Required range: 0 <= x <= 10000

externalId

string

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

provider

enum<string>

The provider handling this allocation.

Available options:

M0,

Yield.xyz

Id of the fee sponsor that will pay the network fees for this allocation. When set, allocation transactions are broadcast as sponsored user operations.

Required string length: 1 - 64

Pattern: ^fs-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"fs-5vqdl-gliqk-b4rfukqauov1sp7j"

Response

200 - application/json

Success

A allocation investment representing funds deposited to earn interest from a DeFi protocol.

string

required

Unique identifier for the allocation investment.

Required string length: 1 - 64

Pattern: ^allctn-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"allctn-7mnn0-rltpq-9bvps60gjm09td0j"

walletId

string

required

Wallet id.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

protocol

enum<string>

required

The DeFi protocol used for allocation generation.

Available options:

0fns,

SkySusds,

GauntletUsdcPrime,

SteakhouseUsdt,

GauntletUsdcPrimeBase,

SteakhouseUsdcBase,

SentoraPyusdMain

amount

Native Asset · object

required

The total amount currently invested in this allocation.

Native Asset
EVM Fungible Token (ERC-20)
Solana Fungible Token (SPL)

Show child attributes

rewards

Native Asset · object

required

The total rewards earned so far in this allocation.

Native Asset
EVM Fungible Token (ERC-20)
Solana Fungible Token (SPL)

Show child attributes

dateCreated

string<date-time>

required

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

Example:

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

actions

object[]

required

Show child attributes

provider

enum<string>

The provider handling this allocation.

Available options:

M0,

Yield.xyz

Last modified on July 9, 2026

List Allocations

Get Allocation

⌘I

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Create Allocation

Authentication

Required Permissions

Authorizations

Body

Response

​Authentication

​Required Permissions

Authorizations

Body

Response

Authentication

Required Permissions