Exchange Pint

curl --request POST \
  --url https://api.sumvin.com/v0/pint/exchange \
  --header 'Content-Type: application/json' \
  --header 'x-juno-jwt: <api-key>' \
  --data '
{
  "pint": {
    "wallet": "<string>",
    "nonce": 123,
    "statement": "<string>",
    "scopes": [
      "<string>"
    ],
    "resources": [
      "<string>"
    ],
    "max_amount": "<string>",
    "max_amount_token": "<string>",
    "expires_at": 123,
    "conditions": [
      "<string>"
    ]
  },
  "signature": "<string>",
  "audience": "<string>",
  "source_chat_message_id": 12345,
  "parent_pint_uri": "sr:us:pint:9f2c1e7a4b8d"
}
'

import requests

url = "https://api.sumvin.com/v0/pint/exchange"

payload = {
    "pint": {
        "wallet": "<string>",
        "nonce": 123,
        "statement": "<string>",
        "scopes": ["<string>"],
        "resources": ["<string>"],
        "max_amount": "<string>",
        "max_amount_token": "<string>",
        "expires_at": 123,
        "conditions": ["<string>"]
    },
    "signature": "<string>",
    "audience": "<string>",
    "source_chat_message_id": 12345,
    "parent_pint_uri": "sr:us:pint:9f2c1e7a4b8d"
}
headers = {
    "x-juno-jwt": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-juno-jwt': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pint: {
      wallet: '<string>',
      nonce: 123,
      statement: '<string>',
      scopes: ['<string>'],
      resources: ['<string>'],
      max_amount: '<string>',
      max_amount_token: '<string>',
      expires_at: 123,
      conditions: ['<string>']
    },
    signature: '<string>',
    audience: '<string>',
    source_chat_message_id: 12345,
    parent_pint_uri: 'sr:us:pint:9f2c1e7a4b8d'
  })
};

fetch('https://api.sumvin.com/v0/pint/exchange', 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.sumvin.com/v0/pint/exchange",
  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([
    'pint' => [
        'wallet' => '<string>',
        'nonce' => 123,
        'statement' => '<string>',
        'scopes' => [
                '<string>'
        ],
        'resources' => [
                '<string>'
        ],
        'max_amount' => '<string>',
        'max_amount_token' => '<string>',
        'expires_at' => 123,
        'conditions' => [
                '<string>'
        ]
    ],
    'signature' => '<string>',
    'audience' => '<string>',
    'source_chat_message_id' => 12345,
    'parent_pint_uri' => 'sr:us:pint:9f2c1e7a4b8d'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-juno-jwt: <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.sumvin.com/v0/pint/exchange"

	payload := strings.NewReader("{\n  \"pint\": {\n    \"wallet\": \"<string>\",\n    \"nonce\": 123,\n    \"statement\": \"<string>\",\n    \"scopes\": [\n      \"<string>\"\n    ],\n    \"resources\": [\n      \"<string>\"\n    ],\n    \"max_amount\": \"<string>\",\n    \"max_amount_token\": \"<string>\",\n    \"expires_at\": 123,\n    \"conditions\": [\n      \"<string>\"\n    ]\n  },\n  \"signature\": \"<string>\",\n  \"audience\": \"<string>\",\n  \"source_chat_message_id\": 12345,\n  \"parent_pint_uri\": \"sr:us:pint:9f2c1e7a4b8d\"\n}")

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

	req.Header.Add("x-juno-jwt", "<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.sumvin.com/v0/pint/exchange")
  .header("x-juno-jwt", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"pint\": {\n    \"wallet\": \"<string>\",\n    \"nonce\": 123,\n    \"statement\": \"<string>\",\n    \"scopes\": [\n      \"<string>\"\n    ],\n    \"resources\": [\n      \"<string>\"\n    ],\n    \"max_amount\": \"<string>\",\n    \"max_amount_token\": \"<string>\",\n    \"expires_at\": 123,\n    \"conditions\": [\n      \"<string>\"\n    ]\n  },\n  \"signature\": \"<string>\",\n  \"audience\": \"<string>\",\n  \"source_chat_message_id\": 12345,\n  \"parent_pint_uri\": \"sr:us:pint:9f2c1e7a4b8d\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sumvin.com/v0/pint/exchange")

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

request = Net::HTTP::Post.new(url)
request["x-juno-jwt"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"pint\": {\n    \"wallet\": \"<string>\",\n    \"nonce\": 123,\n    \"statement\": \"<string>\",\n    \"scopes\": [\n      \"<string>\"\n    ],\n    \"resources\": [\n      \"<string>\"\n    ],\n    \"max_amount\": \"<string>\",\n    \"max_amount_token\": \"<string>\",\n    \"expires_at\": 123,\n    \"conditions\": [\n      \"<string>\"\n    ]\n  },\n  \"signature\": \"<string>\",\n  \"audience\": \"<string>\",\n  \"source_chat_message_id\": 12345,\n  \"parent_pint_uri\": \"sr:us:pint:9f2c1e7a4b8d\"\n}"

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

{
  "_links": {},
  "sig": "<string>",
  "id": "<string>",
  "audience": "<string>",
  "scopes": [
    "<string>"
  ],
  "expires_at": 123,
  "sri": "<string>"
}

{
  "_links": {},
  "sig": "<string>",
  "id": "<string>",
  "audience": "<string>",
  "scopes": [
    "<string>"
  ],
  "expires_at": 123,
  "sri": "<string>"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

POST

pint

exchange

Exchange Pint

curl --request POST \
  --url https://api.sumvin.com/v0/pint/exchange \
  --header 'Content-Type: application/json' \
  --header 'x-juno-jwt: <api-key>' \
  --data '
{
  "pint": {
    "wallet": "<string>",
    "nonce": 123,
    "statement": "<string>",
    "scopes": [
      "<string>"
    ],
    "resources": [
      "<string>"
    ],
    "max_amount": "<string>",
    "max_amount_token": "<string>",
    "expires_at": 123,
    "conditions": [
      "<string>"
    ]
  },
  "signature": "<string>",
  "audience": "<string>",
  "source_chat_message_id": 12345,
  "parent_pint_uri": "sr:us:pint:9f2c1e7a4b8d"
}
'

import requests

url = "https://api.sumvin.com/v0/pint/exchange"

payload = {
    "pint": {
        "wallet": "<string>",
        "nonce": 123,
        "statement": "<string>",
        "scopes": ["<string>"],
        "resources": ["<string>"],
        "max_amount": "<string>",
        "max_amount_token": "<string>",
        "expires_at": 123,
        "conditions": ["<string>"]
    },
    "signature": "<string>",
    "audience": "<string>",
    "source_chat_message_id": 12345,
    "parent_pint_uri": "sr:us:pint:9f2c1e7a4b8d"
}
headers = {
    "x-juno-jwt": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-juno-jwt': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    pint: {
      wallet: '<string>',
      nonce: 123,
      statement: '<string>',
      scopes: ['<string>'],
      resources: ['<string>'],
      max_amount: '<string>',
      max_amount_token: '<string>',
      expires_at: 123,
      conditions: ['<string>']
    },
    signature: '<string>',
    audience: '<string>',
    source_chat_message_id: 12345,
    parent_pint_uri: 'sr:us:pint:9f2c1e7a4b8d'
  })
};

fetch('https://api.sumvin.com/v0/pint/exchange', 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.sumvin.com/v0/pint/exchange",
  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([
    'pint' => [
        'wallet' => '<string>',
        'nonce' => 123,
        'statement' => '<string>',
        'scopes' => [
                '<string>'
        ],
        'resources' => [
                '<string>'
        ],
        'max_amount' => '<string>',
        'max_amount_token' => '<string>',
        'expires_at' => 123,
        'conditions' => [
                '<string>'
        ]
    ],
    'signature' => '<string>',
    'audience' => '<string>',
    'source_chat_message_id' => 12345,
    'parent_pint_uri' => 'sr:us:pint:9f2c1e7a4b8d'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-juno-jwt: <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.sumvin.com/v0/pint/exchange"

	payload := strings.NewReader("{\n  \"pint\": {\n    \"wallet\": \"<string>\",\n    \"nonce\": 123,\n    \"statement\": \"<string>\",\n    \"scopes\": [\n      \"<string>\"\n    ],\n    \"resources\": [\n      \"<string>\"\n    ],\n    \"max_amount\": \"<string>\",\n    \"max_amount_token\": \"<string>\",\n    \"expires_at\": 123,\n    \"conditions\": [\n      \"<string>\"\n    ]\n  },\n  \"signature\": \"<string>\",\n  \"audience\": \"<string>\",\n  \"source_chat_message_id\": 12345,\n  \"parent_pint_uri\": \"sr:us:pint:9f2c1e7a4b8d\"\n}")

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

	req.Header.Add("x-juno-jwt", "<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.sumvin.com/v0/pint/exchange")
  .header("x-juno-jwt", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"pint\": {\n    \"wallet\": \"<string>\",\n    \"nonce\": 123,\n    \"statement\": \"<string>\",\n    \"scopes\": [\n      \"<string>\"\n    ],\n    \"resources\": [\n      \"<string>\"\n    ],\n    \"max_amount\": \"<string>\",\n    \"max_amount_token\": \"<string>\",\n    \"expires_at\": 123,\n    \"conditions\": [\n      \"<string>\"\n    ]\n  },\n  \"signature\": \"<string>\",\n  \"audience\": \"<string>\",\n  \"source_chat_message_id\": 12345,\n  \"parent_pint_uri\": \"sr:us:pint:9f2c1e7a4b8d\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sumvin.com/v0/pint/exchange")

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

request = Net::HTTP::Post.new(url)
request["x-juno-jwt"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"pint\": {\n    \"wallet\": \"<string>\",\n    \"nonce\": 123,\n    \"statement\": \"<string>\",\n    \"scopes\": [\n      \"<string>\"\n    ],\n    \"resources\": [\n      \"<string>\"\n    ],\n    \"max_amount\": \"<string>\",\n    \"max_amount_token\": \"<string>\",\n    \"expires_at\": 123,\n    \"conditions\": [\n      \"<string>\"\n    ]\n  },\n  \"signature\": \"<string>\",\n  \"audience\": \"<string>\",\n  \"source_chat_message_id\": 12345,\n  \"parent_pint_uri\": \"sr:us:pint:9f2c1e7a4b8d\"\n}"

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

{
  "_links": {},
  "sig": "<string>",
  "id": "<string>",
  "audience": "<string>",
  "scopes": [
    "<string>"
  ],
  "expires_at": 123,
  "sri": "<string>"
}

{
  "_links": {},
  "sig": "<string>",
  "id": "<string>",
  "audience": "<string>",
  "scopes": [
    "<string>"
  ],
  "expires_at": 123,
  "sri": "<string>"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

{
  "detail": "No wallet found with ID 12345 for this user.",
  "error_code": "WAL-404-001",
  "instance": "/v0/wallets/12345",
  "status": 404,
  "title": "Wallet Not Found",
  "trace_id": "abc123-def456-ghi789",
  "type": "https://api.sumvin.com/errors/wal-404-001"
}

Authorizations

x-juno-jwt

string

header

required

JWT issued by Dynamic Labs or Privy. Sent in the x-juno-jwt header on every authenticated request.

Headers

x-juno-orgid

string | null

Tenant org ID for multi-tenant auth

x-sumvin-token

string | null

x-sumvin-pat

string | null

x-juno-jwt

string | null

X-Timestamp-Format

string

Controls how timestamp fields are serialized in JSON response bodies.

Default (header omitted or any other value): epoch milliseconds as integers. iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.

Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".

Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.

Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.

Example:

"iso8601"

Query Parameters

agent

boolean

default:false

Set to true to have the server sign the purchase intent with your own agent signer and address the token to you. In this mode the signature must be omitted and the wallet must be your primary smart wallet. When false (the default), you supply the signature; name a third party in audience, or omit it to address the token to yourself.

Body

application/json

pint

PurchaseIntentPayload · object

required

Show child attributes

signature

string | null

The wallet's EIP-712 signature over the purchase intent, 65 bytes hex with a 0x prefix. Required for direct minting. Omit it when minting with agent=true, where the server signs on the caller's behalf.

audience

string | null

The identifier of the third party the minted token is addressed to. Omit it to address the token to yourself, which the server resolves to your own identity. It must not name your own account — omit it instead.

source_chat_message_id

integer | null

Optional chat message ID correlating this PINT back to the conversation that generated it. When provided, the message must belong to a chat session owned by the authenticated user.

Example:

12345

parent_pint_uri

string | null

Optional URI of an existing PINT this one is allocated against, recording the lineage between them. The parent must belong to the same wallet as this PINT and must itself authorise a purchase that is still open to further spending — an allocation against a purchase that has finished, expired or been cancelled is refused. A PINT allocated against a parent must stay within what the parent authorises: its scopes must be exactly those the parent permits for the requested amount — the same currency and card, with the amount within the parent's limit — its top-level max_amount and max_amount_token must be zero (the spending ceiling is carried by its checkout scope), and it may not expire after the parent. A request that does not match is refused.

Maximum string length: 512

Example:

"sr:us:pint:9f2c1e7a4b8d"

Response

Successful Response

_links

Links · object

required

HAL-style hypermedia links for navigation and available actions.

Show child attributes

sig

string

required

JWT token issued for the PINT

string

required

PINT URI

audience

string

required

scopes

string[]

required

expires_at

integer

required

sri

string | null

Sumvin Resource Identifier for the signer

⌘I

Introduction

Quickstarts

Guides

Product Guides

API Reference

Exchange Pint

Authorizations

Headers

Query Parameters

Body

Response