API Reference

Version 1 of the MidasAI REST API. All endpoints require a valid API key unless noted.

Base URL: https://api.midasai.tech

Listings

GET/v1/listingsRequires read

List active marketplace listings

Example

curl -X GET "https://api.midasai.tech/v1/listings" \
  -H "Authorization: YOUR_API_KEY"

GET/v1/listings/:idRequires read

Get a single listing

Example

curl -X GET "https://api.midasai.tech/v1/listings/LISTING_ID" \
  -H "Authorization: YOUR_API_KEY"

POST/v1/listingsRequires write

Create a listing (creator)

Example

curl -X POST "https://api.midasai.tech/v1/listings" \
  -H "Authorization: YOUR_API_KEY"

PUT/v1/listings/:idRequires write

Update your listing

Example

curl -X PUT "https://api.midasai.tech/v1/listings/LISTING_ID" \
  -H "Authorization: YOUR_API_KEY"

DELETE/v1/listings/:idRequires delete

Archive your listing

Example

curl -X DELETE "https://api.midasai.tech/v1/listings/LISTING_ID" \
  -H "Authorization: YOUR_API_KEY"

GET/v1/users/meRequires read

Current authenticated user

Example

curl -X GET "https://api.midasai.tech/v1/users/me" \
  -H "Authorization: YOUR_API_KEY"

PUT/v1/users/meRequires write

Update your profile

Example

curl -X PUT "https://api.midasai.tech/v1/users/me" \
  -H "Authorization: YOUR_API_KEY"

GET/v1/users/:idRequires read

Public user profile

Example

curl -X GET "https://api.midasai.tech/v1/users/LISTING_ID" \
  -H "Authorization: YOUR_API_KEY"

GET/v1/analytics/usageRequires read

API usage for your key

Example

curl -X GET "https://api.midasai.tech/v1/analytics/usage" \
  -H "Authorization: YOUR_API_KEY"

GET/v1/analytics/listingsRequires read

Listing performance stats

Example

curl -X GET "https://api.midasai.tech/v1/analytics/listings" \
  -H "Authorization: YOUR_API_KEY"

GET/v1/webhooksRequires read

List webhooks

Example

curl -X GET "https://api.midasai.tech/v1/webhooks" \
  -H "Authorization: YOUR_API_KEY"

POST/v1/webhooksRequires write

Example

curl -X POST "https://api.midasai.tech/v1/webhooks" \
  -H "Authorization: YOUR_API_KEY"

DELETE/v1/webhooks/:idRequires delete

Remove a webhook

Example

curl -X DELETE "https://api.midasai.tech/v1/webhooks/LISTING_ID" \
  -H "Authorization: YOUR_API_KEY"

Successful responses return JSON with a data field. List endpoints include pagination.

json

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3
  }
}

Errors return { "error": "message" } with an appropriate HTTP status code. See errors.