Digital Asset Exchange API Documentation

How the Exchange Works

A three-sided marketplace connecting brands, creators, and audiences with automated performance-based settlements.

Brands Drop Campaigns

Define hashtag topics

Set @mention requirements

Set payout structures

Deposit campaign budgets

Creators Shop & Create

Browse campaign marketplace

Filter by payout amounts

Pick topics they love

Submit viral content

Automated Settlement

Escrow fund protection

Real-time performance tracking

Instant payout triggers

10% exchange commission

Exchange API Endpoints

Complete API reference for the Brand-Creator Marketplace Exchange

Brand Campaign APIs

POST /campaigns

Create a new hashtag campaign with payout structure

{
  "campaign_name": "Fintech Future Campaign",
  "brand_handle": "@etaildepot",
  "hashtags": ["#FintechFuture", "#SmartCards", "#DigitalCommerce"],
  "budget": 50000,
  "payout_structure": {
    "base_payment": 75,
    "milestones": [
      { "views": 500000, "bonus": 500 },
      { "views": 1000000, "bonus": 1500 }
    ]
  },
  "duration_days": 45,
  "content_guidelines": "Showcase fintech innovation"
}

Response: Returns campaign_id and escrow wallet address

GET /campaigns/{id}

Retrieve campaign details and current statistics

{
  "campaign_id": "camp_abc123",
  "status": "active",
  "budget_remaining": 47250,
  "total_submissions": 156,
  "total_payouts": 2750,
  "top_performing_content": [
    {
      "submission_id": "sub_def456",
      "platform": "tiktok",
      "views": 1200000,
      "earnings": 1575
    }
  ]
}

Use Case: Monitor campaign performance and budget usage

Creator Discovery APIs

GET /campaigns/browse

Browse active campaigns with filtering options

Query Parameters:

• min_payout - Minimum total earning potential
• hashtags - Comma-separated hashtag interests
• platform - tiktok, instagram, youtube, x, linkedin
• sort_by - payout_desc, budget_desc, new

Perfect for: Creator marketplace browsing experience

POST /submissions

Submit content to campaign for tracking and payment

{
  "campaign_id": "camp_abc123",
  "creator_id": "creator_xyz789",
  "platform": "tiktok",
  "content_url": "https://tiktok.com/@creator/video/...",
  "hashtags_used": ["#FintechFuture", "#SmartCards"],
  "mentions_used": ["@etaildepot"],
  "submission_proof": "content_screenshot_url"
}

Auto-triggers: $75 base payment + performance tracking

Settlement & Payment APIs

GET /submissions/{id}/performance

Real-time performance metrics and earnings calculation

{
  "submission_id": "sub_def456",
  "current_views": 750000,
  "current_likes": 45600,
  "current_shares": 3200,
  "earnings_breakdown": {
    "base_payment": 75,
    "milestone_bonuses": [500],
    "pending_bonuses": [1500],
    "total_earned": 575,
    "total_potential": 2075
  },
  "next_milestone": {
    "target_views": 1000000,
    "bonus_amount": 1500,
    "progress_percent": 75
  }
}

Updates: Every 15 minutes via social platform APIs

POST /settlements/trigger

Trigger automatic payment when milestones are reached

{
  "settlement_id": "settle_ghi012",
  "submission_id": "sub_def456",
  "milestone_reached": {
    "type": "view_milestone",
    "target": 1000000,
    "actual": 1000000,
    "bonus_amount": 1500
  },
  "payment_status": "processing",
  "estimated_arrival": "2025-01-02T10:30:00Z",
  "exchange_commission": 150,
  "creator_payout": 1350
}

Settlement: Instant crypto or 24hr bank transfer

Quick Start Integration

Get your Brand-Creator Exchange running in minutes

For Brands

1. Create Campaign

curl -X POST https://api.etaildepot.com/campaigns \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Summer Promo",
    "brand_handle": "@yourbrand",
    "hashtags": ["#summer2025", "#promo"],
    "budget": 10000,
    "payout_structure": {
      "base_payment": 50,
      "milestones": [
        {"views": 100000, "bonus": 200}
      ]
    }
  }'

2. Fund Escrow Wallet

Deposit campaign budget to secure creator payments

Use returned escrow_wallet_address from campaign creation

3. Monitor & Analytics

Track submissions, performance, and ROI in real-time via dashboard or API

For Creators

1. Browse Campaigns

curl "https://api.etaildepot.com/campaigns/browse?min_payout=500&platform=tiktok" \
  -H "Authorization: Bearer creator_api_key"

# Returns campaigns sorted by earning potential

2. Submit Content

curl -X POST https://api.etaildepot.com/submissions \
  -H "Authorization: Bearer creator_api_key" \
  -d '{
    "campaign_id": "camp_abc123",
    "platform": "tiktok",
    "content_url": "https://tiktok.com/@me/video/123",
    "hashtags_used": ["#summer2025", "#promo"],
    "mentions_used": ["@yourbrand"]
  }'

3. Get Paid Automatically

Receive $50 base + performance bonuses as your content goes viral

💰 Payments process within 24 hours of milestone completion

Exchange Success Stories

Real results from the Brand-Creator Marketplace

TechStartup Inc.

+847%

Social media reach increase

• 2,400+ creator submissions

• 45M total impressions

• $125K campaign budget

• 3.2M engagement actions

@CreatorSarah

$24,850

Earned in 3 months

• 47 successful submissions

• 8.2M total views generated

• 15 viral milestones hit

• Top 1% creator on platform

Platform Performance

99.8%

Settlement success rate

• 156K+ settlements processed

• 12 sec average settlement time

• $24M+ total volume

• 2,847+ active campaigns