API Documentation

Introduction

The Stickier API allows you to programmatically access market data, execute trades, and manage your sticker portfolio. All endpoints return JSON and use standard HTTP response codes.

Prepaid Balance Required

To buy or sell stickers via the API, you must have sufficient funds in your account balance. Card payments are only available through the web interface. Add funds to your account →

Base URL

https://stickier.com/api

Authentication

The Stickier API uses bearer token authentication. Include your API key in theAuthorizationheader of all requests.

Getting Your API Key

Go to your Account Settings → API
Click "Generate API Key"
Copy and securely store your key (it won't be shown again)

Using Your API Key

Example Requestbash

curl https://stickier.com/api/stickers \
  -H "Authorization: Bearer sk_live_your_api_key"

Keep Your Key Secret

Never expose your API key in client-side code or public repositories. Treat it like a password.

Rate Limits

API requests are rate limited to ensure fair usage and system stability.

Limit	Window	Notes
100 requests	per minute	Standard tier

Rate limit headers are included in all responses: X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset

List Stickers

GET/api/stickers

Retrieve a list of all available stickers or filter by category, tags, or search query.

Query Parameters

Parameter	Type	Description
`slug`	string	Get single sticker by slug (e.g., 'stripe')
`ticker`	string	Get single sticker by ticker (e.g., 'STRP')
`category`	string	Filter by category: private, public, yc, bootstrapped
`tags`	string	Comma-separated tags (e.g., 'ai-ml,fintech')
`featured`	boolean	Only featured stickers
`sort`	string	Sort order: popular, newest, price-high, price-low
`limit`	number	Max results (default 100, max 100)
`offset`	number	Pagination offset

Example Request

curl "https://stickier.com/api/stickers?category=yc&limit=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "stickers": [
      {
        "id": "abc123",
        "ticker": "STRP",
        "slug": "stripe",
        "name": "Stripe",
        "description": "Financial infrastructure for the internet",
        "category": "private",
        "currentPriceCents": 150,
        "priceFormatted": "$1.50",
        "circulatingSupply": 342,
        "websiteUrl": "https://stripe.com",
        "logoUrl": "https://cdn.brandfetch.io/stripe.com/logo",
        "stickerImageUrl": "https://stickier.com/api/stickers/stripe.svg",
        "isFeatured": true,
        "isActive": true
      }
    ],
    "pagination": {
      "total": 1250,
      "limit": 10,
      "offset": 0,
      "hasMore": true
    }
  }
}

Get Prices

GET/api/prices

Get current prices for all stickers or specific stickers by ID. Prices are returned in cents and as formatted strings.

Query Parameters

Parameter	Type	Description
`companies`	string[]	Company IDs to get prices for (can be repeated)

Example Request

curl "https://stickier.com/api/prices" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "prices": {
      "company_abc123": {
        "cents": 150,
        "formatted": "$1.50"
      },
      "company_def456": {
        "cents": 275,
        "formatted": "$2.75"
      },
      "company_ghi789": {
        "cents": 50,
        "formatted": "$0.50"
      }
    }
  }
}

Public JSON API

You can also access individual sticker data at /{slug}.jsonwithout authentication. For example: stickier.com/stripe.json

Trade Preview

GET/api/trades/preview

Get a quote for a trade before executing it. Returns the expected cost, fees, and price impact (slippage) for the given quantity.

Query Parameters

Parameter	Type	Description
`companyId`required	string	ID of the sticker to trade
`type`required	string	Trade type: buy, sell, or short
`quantity`required	number	Number of stickers (1-1000)

Example Request

curl "https://stickier.com/api/trades/preview?companyId=abc123&type=buy&quantity=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "type": "buy",
    "quantity": 10,
    "spotPriceCents": 150,
    "avgPriceCents": 152,
    "totalCostCents": 1520,
    "lowPriceSurchargeCents": 0,
    "finalTotalCents": 1520,
    "newPriceCents": 155,
    "priceImpactPercent": 3.33,
    "formatted": {
      "spotPrice": "$1.50",
      "avgPrice": "$1.52",
      "total": "$15.20",
      "newPrice": "$1.55"
    }
  }
}

Execute Orders

POST/api/trades

Execute a buy, sell, or short trade. Trades are executed immediately at the current market price (with slippage for quantity). Requires sufficient account balance.

Request Body

Parameter	Type	Description
`companyId`required	string	ID of the sticker to trade
`type`required	string	Trade type: buy, sell, or short
`quantity`required	number	Number of stickers (1-1000)
`options.shippingMode`	string	ship_now or ship_later (default: ship_later)

Example Request

curl -X POST "https://stickier.com/api/trades" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "abc123",
    "type": "buy",
    "quantity": 10,
    "options": {
      "shippingMode": "ship_later"
    }
  }'

Response

Response200 OK

{
  "success": true,
  "data": {
    "trade": {
      "id": "trade_xyz789",
      "type": "buy",
      "quantity": 10,
      "priceCents": 152,
      "totalCents": 1520,
      "executedAt": "2026-01-13T12:00:00.000Z"
    },
    "priceUpdate": {
      "previousPriceCents": 150,
      "newPriceCents": 155,
      "changeCents": 5
    },
    "balance": {
      "previousCents": 10000,
      "newCents": 8480
    }
  }
}

Error Codes

Code	Description
`INSUFFICIENT_BALANCE`	Not enough funds in account
`INSUFFICIENT_INVENTORY`	Not enough stickers to sell
`NOT_FOUND`	Sticker not found

Your Holdings

GET/api/user/inventory

Get your current sticker holdings, including quantities, cost basis, and current values.

Example Request

curl "https://stickier.com/api/user/inventory" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "holdings": [
      {
        "companyId": "abc123",
        "ticker": "STRP",
        "name": "Stripe",
        "quantity": 50,
        "holdingType": "held",
        "avgCostCents": 125,
        "currentPriceCents": 150,
        "valueCents": 7500,
        "pnlCents": 1250,
        "pnlPercent": 20,
        "listedQuantity": 0
      },
      {
        "companyId": "def456",
        "ticker": "OAI",
        "name": "OpenAI",
        "quantity": 25,
        "holdingType": "held",
        "avgCostCents": 300,
        "currentPriceCents": 275,
        "valueCents": 6875,
        "pnlCents": -625,
        "pnlPercent": -8.33,
        "listedQuantity": 5
      }
    ],
    "summary": {
      "totalValueCents": 14375,
      "totalCostCents": 13125,
      "totalPnlCents": 1250,
      "totalPnlPercent": 9.52,
      "holdingsCount": 2
    }
  }
}

Holding Types

Type	Description
`held`	Tradable stickers stored in your collection
`pending`	Stickers queued for shipping (not tradable)
`shipped`	Stickers that have been shipped
`shorted`	Bear flex stickers (cosmetic only)

Ready to start building?

Get your API key and start integrating with Stickier in minutes.

Get API Key Add Funds

Introduction

The Stickier API allows you to programmatically access market data, execute trades, and manage your sticker portfolio. All endpoints return JSON and use standard HTTP response codes.

Prepaid Balance Required

To buy or sell stickers via the API, you must have sufficient funds in your account balance. Card payments are only available through the web interface. Add funds to your account →

Base URL

https://stickier.com/api

Authentication

The Stickier API uses bearer token authentication. Include your API key in theAuthorizationheader of all requests.

Getting Your API Key

Go to your Account Settings → API
Click "Generate API Key"
Copy and securely store your key (it won't be shown again)

Using Your API Key

Example Requestbash

curl https://stickier.com/api/stickers \
  -H "Authorization: Bearer sk_live_your_api_key"

Keep Your Key Secret

Never expose your API key in client-side code or public repositories. Treat it like a password.

Rate Limits

API requests are rate limited to ensure fair usage and system stability.

Limit	Window	Notes
100 requests	per minute	Standard tier

Rate limit headers are included in all responses: X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset

List Stickers

GET/api/stickers

Retrieve a list of all available stickers or filter by category, tags, or search query.

Query Parameters

Parameter	Type	Description
`slug`	string	Get single sticker by slug (e.g., 'stripe')
`ticker`	string	Get single sticker by ticker (e.g., 'STRP')
`category`	string	Filter by category: private, public, yc, bootstrapped
`tags`	string	Comma-separated tags (e.g., 'ai-ml,fintech')
`featured`	boolean	Only featured stickers
`sort`	string	Sort order: popular, newest, price-high, price-low
`limit`	number	Max results (default 100, max 100)
`offset`	number	Pagination offset

Example Request

curl "https://stickier.com/api/stickers?category=yc&limit=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "stickers": [
      {
        "id": "abc123",
        "ticker": "STRP",
        "slug": "stripe",
        "name": "Stripe",
        "description": "Financial infrastructure for the internet",
        "category": "private",
        "currentPriceCents": 150,
        "priceFormatted": "$1.50",
        "circulatingSupply": 342,
        "websiteUrl": "https://stripe.com",
        "logoUrl": "https://cdn.brandfetch.io/stripe.com/logo",
        "stickerImageUrl": "https://stickier.com/api/stickers/stripe.svg",
        "isFeatured": true,
        "isActive": true
      }
    ],
    "pagination": {
      "total": 1250,
      "limit": 10,
      "offset": 0,
      "hasMore": true
    }
  }
}

Get Prices

GET/api/prices

Get current prices for all stickers or specific stickers by ID. Prices are returned in cents and as formatted strings.

Query Parameters

Parameter	Type	Description
`companies`	string[]	Company IDs to get prices for (can be repeated)

Example Request

curl "https://stickier.com/api/prices" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "prices": {
      "company_abc123": {
        "cents": 150,
        "formatted": "$1.50"
      },
      "company_def456": {
        "cents": 275,
        "formatted": "$2.75"
      },
      "company_ghi789": {
        "cents": 50,
        "formatted": "$0.50"
      }
    }
  }
}

Public JSON API

You can also access individual sticker data at /{slug}.jsonwithout authentication. For example: stickier.com/stripe.json

Trade Preview

GET/api/trades/preview

Get a quote for a trade before executing it. Returns the expected cost, fees, and price impact (slippage) for the given quantity.

Query Parameters

Parameter	Type	Description
`companyId`required	string	ID of the sticker to trade
`type`required	string	Trade type: buy, sell, or short
`quantity`required	number	Number of stickers (1-1000)

Example Request

curl "https://stickier.com/api/trades/preview?companyId=abc123&type=buy&quantity=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "type": "buy",
    "quantity": 10,
    "spotPriceCents": 150,
    "avgPriceCents": 152,
    "totalCostCents": 1520,
    "lowPriceSurchargeCents": 0,
    "finalTotalCents": 1520,
    "newPriceCents": 155,
    "priceImpactPercent": 3.33,
    "formatted": {
      "spotPrice": "$1.50",
      "avgPrice": "$1.52",
      "total": "$15.20",
      "newPrice": "$1.55"
    }
  }
}

Execute Orders

POST/api/trades

Execute a buy, sell, or short trade. Trades are executed immediately at the current market price (with slippage for quantity). Requires sufficient account balance.

Request Body

Parameter	Type	Description
`companyId`required	string	ID of the sticker to trade
`type`required	string	Trade type: buy, sell, or short
`quantity`required	number	Number of stickers (1-1000)
`options.shippingMode`	string	ship_now or ship_later (default: ship_later)

Example Request

curl -X POST "https://stickier.com/api/trades" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "abc123",
    "type": "buy",
    "quantity": 10,
    "options": {
      "shippingMode": "ship_later"
    }
  }'

Response

Response200 OK

{
  "success": true,
  "data": {
    "trade": {
      "id": "trade_xyz789",
      "type": "buy",
      "quantity": 10,
      "priceCents": 152,
      "totalCents": 1520,
      "executedAt": "2026-01-13T12:00:00.000Z"
    },
    "priceUpdate": {
      "previousPriceCents": 150,
      "newPriceCents": 155,
      "changeCents": 5
    },
    "balance": {
      "previousCents": 10000,
      "newCents": 8480
    }
  }
}

Error Codes

Code	Description
`INSUFFICIENT_BALANCE`	Not enough funds in account
`INSUFFICIENT_INVENTORY`	Not enough stickers to sell
`NOT_FOUND`	Sticker not found

Your Holdings

GET/api/user/inventory

Get your current sticker holdings, including quantities, cost basis, and current values.

Example Request

curl "https://stickier.com/api/user/inventory" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

Response200 OK

{
  "success": true,
  "data": {
    "holdings": [
      {
        "companyId": "abc123",
        "ticker": "STRP",
        "name": "Stripe",
        "quantity": 50,
        "holdingType": "held",
        "avgCostCents": 125,
        "currentPriceCents": 150,
        "valueCents": 7500,
        "pnlCents": 1250,
        "pnlPercent": 20,
        "listedQuantity": 0
      },
      {
        "companyId": "def456",
        "ticker": "OAI",
        "name": "OpenAI",
        "quantity": 25,
        "holdingType": "held",
        "avgCostCents": 300,
        "currentPriceCents": 275,
        "valueCents": 6875,
        "pnlCents": -625,
        "pnlPercent": -8.33,
        "listedQuantity": 5
      }
    ],
    "summary": {
      "totalValueCents": 14375,
      "totalCostCents": 13125,
      "totalPnlCents": 1250,
      "totalPnlPercent": 9.52,
      "holdingsCount": 2
    }
  }
}

Holding Types

Type	Description
`held`	Tradable stickers stored in your collection
`pending`	Stickers queued for shipping (not tradable)
`shipped`	Stickers that have been shipped
`shorted`	Bear flex stickers (cosmetic only)

Ready to start building?

Get your API key and start integrating with Stickier in minutes.

Get API Key Add Funds

Build with theStickier API

Introduction

Prepaid Balance Required

Base URL

Authentication

Getting Your API Key

Using Your API Key

Keep Your Key Secret

Rate Limits

List Stickers

Query Parameters

Example Request

Response

Get Prices

Query Parameters

Example Request

Response

Public JSON API

Trade Preview

Query Parameters

Example Request

Response

Execute Orders

Request Body

Example Request

Response

Error Codes

Your Holdings

Example Request

Response

Holding Types

Ready to start building?

Build with theStickier API

Introduction

Prepaid Balance Required

Base URL

Authentication

Getting Your API Key

Using Your API Key

Keep Your Key Secret

Rate Limits

List Stickers

Query Parameters

Example Request

Response

Get Prices

Query Parameters

Example Request

Response

Public JSON API

Trade Preview

Query Parameters

Example Request

Response

Execute Orders

Request Body

Example Request

Response

Error Codes

Your Holdings

Example Request

Response

Holding Types

Ready to start building?

Build with the
Stickier API

Build with the
Stickier API