Create Token

post

https://api.skyfire.xyz/api/v1/tokens

Create a kya, pay, or kya-pay token as a buyer agent.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

type

string

required

One of kya, pay, or kya-pay. The created token will contain JWT header typ set to <type>+jwt.

buyerTag

string

Buyer’s internal identifier for the token. e.g. "research-agent-xyz"

tokenAmount

string

The amount of funds in currency units allocated to the token. Determines the maximum amount the seller can charge. Must include if this is a payor kya-pay token. For successful token creation, this value must be:

Greater than 0
Less than or equal to the buyer agent wallet balance
Greater than or equal to the seller service minimum token amount (if applicable)

If these conditions are not met, the token creation request will fail.

sellerServiceId

string

ID of an onboarded seller service. Obtain this from the Skyfire Directory. Required when creating a token for an onboarded seller.

sellerDomainOrUrl

string

Domain name or full URL of an external seller. The buyer agent must belong to an organization and authenticate using an Organization Buyer API Key. Required when creating a token for an external seller.

expiresAt

int64

Unix timestamp (seconds). Defaults to the maximum allowed lifetimes:

24 hours when using sellerServiceId
5 minutes when using sellerDomainOrUrl

Must be between 10s and the maximum allowed lifetime for the selected target type.

identityPermissions

array of strings

Default: empty array. Can be specified if this is a kya or kya-pay token. Additional identity fields to include in the token. See https://docs.skyfire.xyz/reference/identity-fields for more info.

identityPermissions

Responses

Language

Credentials

Header

Loading…

Response

Choose an example:

application/json

200200

401401

402402

422422