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"
}
'

{
  "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"
}

Create Allocation

Create a new allocation.

An allocation deposits assets from one of your wallets into a rewards-earning protocol. Two providers are available:

Provider	Description	Supported chains
M0	Offers the `0fns` protocol, an extension to the M0 USD-based stablecoin $M. Trade USDC on Ethereum into 0fns to earn rewards.	Ethereum Mainnet, Ethereum Sepolia
Yield.xyz	Offers a set of DeFi vault strategies, each with its own APY. Deposit the vault’s underlying token; withdraw it at any time.	Ethereum Mainnet, Base

The protocol field selects the strategy:

`protocol`	Provider	Strategy	Deposit asset	Network
`0fns`	M0	0fns	USDC	Ethereum
`SkySusds`	Yield.xyz	Sky Savings Rate (sUSDS)	USDS	Ethereum
`GauntletUsdcPrime`	Yield.xyz	Gauntlet USDC Prime (gtUSDC)	USDC	Ethereum
`SteakhouseUsdt`	Yield.xyz	Steakhouse USDT (steakUSDT)	USDT	Ethereum
`GauntletUsdcPrimeBase`	Yield.xyz	Gauntlet USDC Prime (gtUSDCp)	USDC	Base
`SteakhouseUsdcBase`	Yield.xyz	Steakhouse USDC (steakUSDC)	USDC	Base
`SentoraPyusdMain`	Yield.xyz	Sentora PYUSD Main (senPYUSDMain)	PYUSD	Ethereum

Yield.xyz vaults are available on mainnet networks only.

POST

allocations

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"
}
'

{
  "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 and the sponsoree wallet belongs to an EndUser user kind.

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. M0 offers the 0fns protocol; Yield.xyz offers vault strategies on Ethereum and Base.

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. See Create Allocation for each protocol's provider, deposit asset, and network.

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 September 11, 2026

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