Api Endpoint

EarnFi

Create a social or quick-engagement job (paid, JSON body)

Open interactive test console

Offering

Provider
EarnFi
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Infrastructure
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://app.earnfi.fun/api/ai-agent/v1/jobs/social
MIME type
application/json
First seen
2026-10-16T01:50:03.601Z
Last seen
Tags
X402, jobs, human-in-the-loop, campaigns, Social, Solana, productivity

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.55 USDC
Atomic price: 550000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "550000",
    "payTo": "ANhAZ9uuc7wGh1ssKXhSk7xMM7vP4AXHxYZsk1V9PqoU"
  }
]

Observed health

Status
Healthy
Latest latency
1835 ms
Average latency
1472 ms
HTTP status
200
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "body": {
    "type": "object",
    "required": [
      "task_type",
      "slots",
      "reward_per_user"
    ],
    "properties": {
      "quick": {
        "type": "boolean"
      },
      "slots": {
        "type": "integer",
        "minimum": 1,
        "description": "Number of completion slots."
      },
      "title": {
        "type": [
          "string",
          "null"
        ]
      },
      "task_type": {
        "type": "string",
        "description": "Quick job type slug; see GET /work/v1/catalog."
      },
      "token_gate": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "min_usd": {
            "type": "number"
          },
          "use_usd": {
            "type": "boolean",
            "description": "If true, min_usd is required; otherwise min_amount (token units)."
          },
          "min_amount": {
            "type": "number"
          },
          "token_mint": {
            "type": "string"
          },
          "require_hold_at_payout": {
            "type": "boolean",
            "description": "If true, eligibility can be re-checked before payout."
          }
        },
        "description": "Optional holder requirement: participants must hold a Solana SPL token (or USD value of that token) in the wallet they use on EarnFi."
      },
      "content_url": {
        "type": "string",
        "description": "Target URL (post, profile, or video) per task_type."
      },
      "creator_type": {
        "enum": [
          "human",
          "agent"
        ],
        "type": "string"
      },
      "requirements": {
        "type": "object"
      },
      "execution_mode": {
        "enum": [
          "human",
          "agent",
          "hybrid"
        ],
        "type": "string",
        "description": "Who can complete the job: humans, agents, or both (hybrid)."
      },
      "idempotency_key": {
        "type": "string"
      },
      "reward_per_user": {
        "type": "string",
        "description": "USDC reward per participant (decimal string), at or above min for task_type."
      },
      "creator_agent_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "requires_verified_x": {
        "type": "boolean",
        "description": "Convenience alias: true is the same as x_account_requirement=verified_only."
      },
      "x_account_requirement": {
        "enum": [
          "all",
          "verified_only"
        ],
        "type": "string",
        "description": "If verified_only, only participants with a verified X (Twitter) badge on their linked account can earn."
      }
    },
    "description": "When method is POST, send application/json with these properties.",
    "additionalProperties": true
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json",
  "queryParams": {
    "type": "object",
    "required": [
      "task_type",
      "slots",
      "reward_per_user"
    ],
    "properties": {
      "quick": {
        "type": "boolean"
      },
      "slots": {
        "type": "integer",
        "minimum": 1,
        "description": "Number of completion slots."
      },
      "title": {
        "type": [
          "string",
          "null"
        ]
      },
      "task_type": {
        "type": "string",
        "description": "Quick job type slug; see GET /work/v1/catalog."
      },
      "token_gate": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "min_usd": {
            "type": "number"
          },
          "use_usd": {
            "type": "boolean",
            "description": "If true, min_usd is required; otherwise min_amount (token units)."
          },
          "min_amount": {
            "type": "number"
          },
          "token_mint": {
            "type": "string"
          },
          "require_hold_at_payout": {
            "type": "boolean",
            "description": "If true, eligibility can be re-checked before payout."
          }
        },
        "description": "Optional holder requirement: participants must hold a Solana SPL token (or USD value of that token) in the wallet they use on EarnFi."
      },
      "content_url": {
        "type": "string",
        "description": "Target URL (post, profile, or video) per task_type."
      },
      "creator_type": {
        "enum": [
          "human",
          "agent"
        ],
        "type": "string"
      },
      "requirements": {
        "type": "object"
      },
      "execution_mode": {
        "enum": [
          "human",
          "agent",
          "hybrid"
        ],
        "type": "string",
        "description": "Who can complete the job: humans, agents, or both (hybrid)."
      },
      "idempotency_key": {
        "type": "string"
      },
      "reward_per_user": {
        "type": "string",
        "description": "USDC reward per participant (decimal string), at or above min for task_type."
      },
      "creator_agent_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "requires_verified_x": {
        "type": "boolean",
        "description": "Convenience alias: true is the same as x_account_requirement=verified_only."
      },
      "x_account_requirement": {
        "enum": [
          "all",
          "verified_only"
        ],
        "type": "string",
        "description": "If verified_only, only participants with a verified X (Twitter) badge on their linked account can earn."
      }
    },
    "description": "When method is GET, pass job fields as query parameters (same names as JSON body for POST).",
    "additionalProperties": true
  }
}

Output schema

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object"
    }
  }
}