Skip to main content
POST
/
fee-sponsors
Create Fee Sponsor
curl --request POST \
  --url https://api.dfns.io/fee-sponsors \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '{
  "name": "<string>",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "allowEndUser": false
}'
{
  "id": "fs-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
  "walletId": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
  "network": "Solana",
  "status": "Active",
  "dateCreated": "2023-04-14T20:41:28.715Z"
}

​
Authentication

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

​
Required Permissions

FeeSponsors:Create: Always required.

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
​
walletId
string
required

Id of the wallet that will be used to sponsor the fee for other wallets.

Maximum length: 64
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
name
string

Nickname for the Fee Sponsor. This will be displayed on the transfer modal in the dashboard.

Required string length: 1 - 50
​
allowEndUser
boolean
default:false

Defines whether EndUsers and their delegated wallets can use this Fee Sponsor.

Response

200 - application/json

Success

​
id
string
required

Fee Sponsor id.

Maximum length: 64
Example:

"fs-5vqdl-gliqk-b4rfukqauov1sp7j"

​
walletId
string
required

Id of the wallet that is used to sponsor the fee for other wallets

Maximum length: 64
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
network
enum<string>
required

Network used for the wallet.

Available options:
Algorand,
AlgorandTestnet,
Aptos,
AptosTestnet,
ArbitrumOne,
ArbitrumSepolia,
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,
EthereumGoerli,
EthereumSepolia,
EthereumHolesky,
EthereumHoodi,
FantomOpera,
FantomTestnet,
FlareC,
FlareCCoston2,
Hedera,
HederaTestnet,
Ink,
InkSepolia,
InternetComputer,
Ion,
IonTestnet,
Iota,
IotaTestnet,
KadenaTestnet4,
Kadena,
Kaspa,
Kusama,
Litecoin,
Near,
NearTestnet,
Optimism,
OptimismSepolia,
Origyn,
Plume,
PlumeSepolia,
Polkadot,
Polygon,
PolygonAmoy,
Polymesh,
PolymeshTestnet,
Race,
RaceSepolia,
SeiAtlantic2,
SeiPacific1,
Solana,
SolanaDevnet,
Stellar,
StellarTestnet,
Sui,
SuiTestnet,
Tsc,
TscTestnet1,
Tezos,
TezosGhostnet,
Ton,
TonTestnet,
Tron,
TronNile,
Westend,
XrpLedger,
XrpLedgerTestnet
​
status
enum<string>
required

Fee sponsor status.

Available options:
Active,
Deactivated,
Archived
​
dateCreated
string<date-time>
required

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

Example:

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

​
name
string

Nickname for the Fee Sponsor. This is displayed on the transfer modal in the dashboard.

​
allowEndUser
boolean

Defines whether EndUsers and their delegated wallets can use this Fee Sponsor.

⌘I