API Authorization
Identity & Access Management
Wallets & Transactions
Management
Webhooks
List Allocations
Copy
Ask AI
curl --request GET \
--url https://api.dfns.io/allocations \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"items": [
{
"id": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
"walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
"protocol": "0fns",
"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"
}
],
"nextPageToken": "<string>"
}List Allocations
GET
/
allocations
List Allocations
Copy
Ask AI
curl --request GET \
--url https://api.dfns.io/allocations \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"items": [
{
"id": "allctn-6a3ku-bn8d7-8u5rs1oukojms7k8",
"walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
"protocol": "0fns",
"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"
}
],
"nextPageToken": "<string>"
}Authentication
❌ Account User (AccountUser)✅ Organization User (
CustomerEmployee)❌ Delegated User (
EndUser)✅ Service Account
Required Permissions
Allocations:Read: Always required.Authorizations
Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows
Query Parameters
Maximum number of items to return.
Required range:
1 <= x <= 500Opaque token used to retrieve the next page. Returned as nextPageToken from the previous request.
Minimum string length:
1Response
200 - application/json
Success
Current page items.
Show child attributes
Show child attributes
Unique identifier for the allocation investment.
Required string length:
1 - 64Example:
"allctn-7mnn0-rltpq-9bvps60gjm09td0j"
Wallet id.
Required string length:
1 - 64Example:
"wa-5pfuu-9euek-h0odgb6snva8ph3k"
The DeFi protocol used for allocation generation. Currently supports OFNS protocol
Available options:
0fns The total amount currently invested in this allocation.
- Native Asset
- EVM Fungible Token (ERC-20)
Show child attributes
Show child attributes
Available options:
Native Show child attributes
Show child attributes
Available options:
Algorand, AlgorandTestnet, Aptos, AptosTestnet, ArbitrumOne, ArbitrumSepolia, ArcTestnet, AvalancheC, AvalancheCFuji, BabylonGenesis, BabylonTestnet5, Base, BaseSepolia, Berachain, BerachainBepolia, Bitcoin, BitcoinSignet, BitcoinTestnet3, BitcoinCash, Bob, BobSepolia, Bsc, BscTestnet, Canton, CantonTestnet, Cardano, CardanoPreprod, Celo, CeloAlfajores, Codex, CodexSepolia, CosmosHub4, CosmosIcsTestnet, Dogecoin, Ethereum, EthereumClassic, EthereumClassicMordor, EthereumGoerli, EthereumSepolia, EthereumHolesky, EthereumHoodi, FantomOpera, FantomTestnet, FlareC, FlareCCoston2, FlowEvm, FlowEvmTestnet, Hedera, HederaTestnet, Ink, InkSepolia, InternetComputer, Ion, IonTestnet, Iota, IotaTestnet, Kaspa, Kusama, KusamaAssetHub, Litecoin, Near, NearTestnet, Optimism, OptimismSepolia, Origyn, Plasma, PlasmaTestnet, Plume, PlumeSepolia, Paseo, PaseoAssetHub, Polkadot, PolkadotAssetHub, Polygon, PolygonAmoy, Polymesh, PolymeshTestnet, Race, RaceSepolia, SeiAtlantic2, SeiPacific1, Solana, SolanaDevnet, Starknet, StarknetSepolia, Stellar, StellarTestnet, Sui, SuiTestnet, Tezos, TezosGhostnet, TempoAndantino, Tsc, TscTestnet1, Ton, TonTestnet, Tron, TronNile, Westend, WestendAssetHub, XrpLedger, XrpLedgerTestnet The total rewards earned so far in this allocation.
- Native Asset
- EVM Fungible Token (ERC-20)
Show child attributes
Show child attributes
Available options:
Native Show child attributes
Show child attributes
Available options:
Algorand, AlgorandTestnet, Aptos, AptosTestnet, ArbitrumOne, ArbitrumSepolia, ArcTestnet, AvalancheC, AvalancheCFuji, BabylonGenesis, BabylonTestnet5, Base, BaseSepolia, Berachain, BerachainBepolia, Bitcoin, BitcoinSignet, BitcoinTestnet3, BitcoinCash, Bob, BobSepolia, Bsc, BscTestnet, Canton, CantonTestnet, Cardano, CardanoPreprod, Celo, CeloAlfajores, Codex, CodexSepolia, CosmosHub4, CosmosIcsTestnet, Dogecoin, Ethereum, EthereumClassic, EthereumClassicMordor, EthereumGoerli, EthereumSepolia, EthereumHolesky, EthereumHoodi, FantomOpera, FantomTestnet, FlareC, FlareCCoston2, FlowEvm, FlowEvmTestnet, Hedera, HederaTestnet, Ink, InkSepolia, InternetComputer, Ion, IonTestnet, Iota, IotaTestnet, Kaspa, Kusama, KusamaAssetHub, Litecoin, Near, NearTestnet, Optimism, OptimismSepolia, Origyn, Plasma, PlasmaTestnet, Plume, PlumeSepolia, Paseo, PaseoAssetHub, Polkadot, PolkadotAssetHub, Polygon, PolygonAmoy, Polymesh, PolymeshTestnet, Race, RaceSepolia, SeiAtlantic2, SeiPacific1, Solana, SolanaDevnet, Starknet, StarknetSepolia, Stellar, StellarTestnet, Sui, SuiTestnet, Tezos, TezosGhostnet, TempoAndantino, Tsc, TscTestnet1, Ton, TonTestnet, Tron, TronNile, Westend, WestendAssetHub, XrpLedger, XrpLedgerTestnet token to use as paginationToken to request the next page.
Was this page helpful?
⌘I